File.h

Go to the documentation of this file.

#ifndef __DCL_FILE_H__
#define __DCL_FILE_H__      20041127
 
#ifndef __DCL_CONFIG_H__
#include <dcl/Config.h>
#endif
 
#if __DCL_WINDOWS
    #ifndef _WINDOWS_
        #error "Required windows.h, See dcl/_windows.h"
    #endif
#endif
 
#ifndef __DCL_OBJECT_H__
#include <dcl/Object.h>
#endif
#ifndef __DCL_STRING_H__
#include <dcl/String.h>
#endif
#ifndef __DCL_CHARSET_H__
#include <dcl/Charset.h>
#endif
#ifndef __DCL_DATE_TIME_H__
#include <dcl/DateTime.h>
#endif
#ifndef __DCL_EXCEPTION_H__
#include <dcl/Exception.h>
#endif
 
__DCL_BEGIN_NAMESPACE

class DCLCAPI File : public Object
{
    DECLARE_CLASSINFO(File)
public:
#if __DCL_WINDOWS
    typedef HANDLE HandleType;
    #define STDIN_HANDLE        GetStdHandle(STD_INPUT_HANDLE)
    #define STDOUT_HANDLE       GetStdHandle(STD_OUTPUT_HANDLE)
    #define STDERR_HANDLE       GetStdHandle(STD_ERROR_HANDLE)
    typedef __int64 off_t;
#else
    typedef int HandleType;
    #ifdef STDIN_FILENO
        #define STDIN_HANDLE        STDIN_FILENO
        #define STDOUT_HANDLE       STDOUT_FILENO
        #define STDERR_HANDLE       STDERR_FILENO
    #else
        #define STDIN_HANDLE        0
        #define STDOUT_HANDLE       1
        #define STDERR_HANDLE       2
    #endif
    typedef long long off_t;
#endif
 
    enum OpenFlags
    {
        READONLY        = 0x0001,       // O_RDONLY
        WRITEONLY       = 0x0002,       // O_WRONLY
        READWRITE       = 0x0004,       // O_RDWR
        CREATE          = 0x0010,       // O_CREAT
        EXCLUSIVE       = 0x0020,       // O_EXCL
        NOCTTY          = 0x0040,       // O_NOCTTY
        APPEND          = 0x0100,       // O_APPEND
        TRUNCATE        = 0x0200,       // O_TRUNC
        NONBLOCK        = 0x1000,       // O_NONBLOCK, FILE_FLAG_OVERLAPPED
        SYNC            = 0x2000        // O_SYNC
    };
 
protected:
    File();

    File(HandleType _handle, const String& _path);
 
public:
    virtual String toString() const;

    virtual ~File();

    File(const String& _path, int _oflags = READONLY, int _mode = 0666)
            __DCL_THROWS1(IOException*);

    void open(const String& _path, int _oflags = READONLY, int _mode = 0666)
            __DCL_THROWS1(IOException*);

    File(HandleType _handle, int _ohints, bool _closeOnClose)
            __DCL_THROWS1(IOException*);

    void open(HandleType _handle, int _ohints, bool _closeOnClose)
            __DCL_THROWS1(IOException*);

    virtual void sync()
            __DCL_THROWS1(IOException*);

    virtual void close()
            __DCL_THROWS1(IOException*);

    virtual size_t available() const
            __DCL_THROWS1(IOException*);

    virtual size_t read(void* _buf, size_t _n)
            __DCL_THROWS1(IOException*);

    virtual size_t write(const void* _buf, size_t _n)
            __DCL_THROWS1(IOException*);
 
    enum Whence
    {
        BEGIN,         // SEEK_SET
        CURRENT,     // SEEK_CUR
        END              // SEEK_END
    };

    off_t seek(off_t _offset, int _whence)
            __DCL_THROWS1(IOException*);

    off_t size() const
            __DCL_THROWS1(IOException*);

    DateTime mtime() const
            __DCL_THROWS1(IOException*);
 
    /*
     * 파일의 최종 접근, 수정, 생성 시간을 얻는다.
     */
    bool time(time_t* _atime, time_t* _mtime, time_t* _ctime) const;

    HandleType handle() const { return __handle; }

    const String& path() const { return __path; }
 
protected:
    String          __path;
    HandleType      __handle;
    bool            __closeOnClose;
#if __DCL_WINDOWS
public:
    enum FileType
    {
        UNKNOWN,
        REGULAR,
        PIPE,
        CONSOLE,
        COMM,
        SOCKET
    };

    FileType fileType() const { return __fileType; }
protected:
    FileType        __fileType;
    HANDLE          __readEvent;
    HANDLE          __writeEvent;
#endif
 
public:
    // "dir/prefixXXXXX" 이름의 파일을 생성하여 파일 기술자를 리턴
    static File* openTempFile(
                    const String& _dirname,
                    const String& _prefix,
                    unsigned int _mode = 0666
                    ) __DCL_THROWS1(IOException*);
};
 
__DCL_END_NAMESPACE
 
#endif  // __DCL_FILE_H__