ghc/lib/std/cbits/fileObject.h

   1 #ifndef FILEOBJECT_H
   2 #define FILEOBJECT_H
   3
   4 /*
   5   IOFileObjects are used as part of the IO.Handle
   6   implementation, ensuring that when handles are
   7   finalised, buffers are flushed and FILE* objects
   8   are closed (we really should be using file descriptors
   9   here..)
  10
  11  */
  12
  13 typedef struct _IOFileObject {
  14    int     fd;
  15    void*   buf;
  16    int     bufWPtr;  /* points to next position to write,
  17                           bufRPtr >= bufWPtr <= bufSize.
  18
  19                         For read-only files, bufWPtr = bufSize
  20
  21                         bufWPtr = 0 => buffer is empty.
  22
  23                      */
  24    int     bufRPtr;  /* points to the next char to read
  25                           -1 >= bufRPtr <= bufWPtr
  26
  27                         For write-only files, bufRPtr = 0
  28
  29                         bufRPtr == -1 => buffer is empty.
  30                      */
  31    int     bufSize;
  32    int     flags;
  33    struct _IOFileObject*   connectedTo;
  34 } IOFileObject;
  35
  36 #define FILEOBJ_FLUSH    1
  37 #define FILEOBJ_LB       2
  38 #define FILEOBJ_BB       4
  39 #define FILEOBJ_EOF      8
  40 #define FILEOBJ_READ    16
  41 #define FILEOBJ_WRITE   32
  42 #define FILEOBJ_STD     64
  43 /* The next two flags are used for RW file objects only.
  44    They indicate whether the last operation was a read or a write.
  45    (Need this info to determine whether a RW file object's
  46     buffer should be flushed before doing a subsequent
  47     read or write).
  48 */
  49 #define FILEOBJ_RW_READ 256
  50 #define FILEOBJ_RW_WRITE 512
  51 /*
  52  * Under Win32, a file fd is not the same as a socket fd, so
  53  * we need to use separate r/w calls.
  54  */
  55 #define FILEOBJ_WINSOCK  1024
  56
  57 #define FILEOBJ_IS_EOF(x)     ((x)->flags & FILEOBJ_EOF)
  58 #define FILEOBJ_SET_EOF(x)    ((x)->flags |= FILEOBJ_EOF)
  59 #define FILEOBJ_CLEAR_EOF(x)  ((x)->flags &= ~FILEOBJ_EOF)
  60 #define FILEOBJ_CLEAR_ERR(x)  FILEOBJ_CLEAR_EOF(x)
  61
  62 #define FILEOBJ_BLOCKED_READ   -5
  63 #define FILEOBJ_BLOCKED_WRITE  -6
  64 #define FILEOBJ_BLOCKED_CONN_WRITE  -7
  65
  66 #define FILEOBJ_UNBUFFERED(x)     (!((x)->flags & FILEOBJ_LB) && !((x)->flags & FILEOBJ_BB))
  67 #define FILEOBJ_LINEBUFFERED(x)   ((x)->flags & FILEOBJ_LB)
  68 #define FILEOBJ_BLOCKBUFFERED(x)  ((x)->flags & FILEOBJ_BB)
  69 #define FILEOBJ_BUFFER_FULL(x)    ((x)->bufWPtr >= (x)->bufSize)
  70 #define FILEOBJ_BUFFER_EMPTY(x)   ((x)->bufRPtr == (x)->bufWPtr)
  71 #define FILEOBJ_HAS_PUSHBACKS(x)  ((x)->buf != NULL && (x)->bufRPtr >= 0 && (x)->bufRPtr < (x)->bufWPtr)
  72 #define FILEOBJ_READABLE(x)       ((x)->flags & FILEOBJ_READ)
  73 #define FILEOBJ_WRITEABLE(x)      ((x)->flags & FILEOBJ_WRITE)
  74 #define FILEOBJ_JUST_READ(x)      ((x)->flags & FILEOBJ_RW_READ)
  75 #define FILEOBJ_JUST_WRITTEN(x)   ((x)->flags & FILEOBJ_RW_WRITE)
  76 #define FILEOBJ_NEEDS_FLUSHING(x) (!FILEOBJ_BUFFER_EMPTY(x))
  77 #define FILEOBJ_RW(x)             (FILEOBJ_READABLE(x) && FILEOBJ_WRITEABLE(x))
  78
  79 #endif /* FILEOBJECT_H */