Class KittyIOFile

KittyMemoryEx/KittyIOFile.hpp:10–391

* @brief This class provides an interface for file operations. */

class KittyIOFile
{
private:
    int _fd;
    std::string _filePath;
    int _flags;
    mode_t _mode;
    int _error;

public:
    /**
     * @brief Default constructor creating an uninitialized file object.
     */
    KittyIOFile() : _fd(-1), _flags(0), _mode(0), _error(0)
    {
    }

    /**
     * @brief Constructs a new KittyIOFile object with file path, flags, and optional mode.
     *
     * @param filePath The path to the file.
     * @param flags The flags for opening the file.
     * @param mode The mode/permissions for opening the file (default: 0).
     */
    KittyIOFile(const std::string &filePath, int flags, mode_t mode = 0)
        : _fd(-1), _filePath(filePath), _flags(flags), _mode(mode), _error(0)
    {
    }

    ~KittyIOFile()
    {
        if (_fd >= 0)
        {
            close();
        }
    }

    KittyIOFile(const KittyIOFile &) = delete;
    KittyIOFile &operator=(const KittyIOFile &) = delete;

    /**
     * @brief Move constructor. Transfers ownership of the file descriptor.
     */
    KittyIOFile(KittyIOFile &&other) noexcept
        : _fd(other._fd), _filePath(std::move(other._filePath)), _flags(other._flags), _mode(other._mode),
          _error(other._error)
    {
        other._fd = -1;
        other._error = 0;
    }

    /**
     * @brief Move assignment operator. Closes current file descriptor and transfers ownership.
     */
    KittyIOFile &operator=(KittyIOFile &&other) noexcept
    {
        if (this != &other)
        {
            close();