6 #ifndef INCLUDED_fileio_h
7 #define INCLUDED_fileio_h
9 #ifndef INCLUDED_sys_types_h
10 #include <sys/types.h> /* size_t */
11 #define INCLUDED_sys_types_h
17 * FileBuf is a mirror of the ANSI FILE struct, but it works for any
18 * file descriptor. FileBufs are allocated when a file is opened with
19 * fbopen, and they are freed when the file is closed using fbclose.
20 * (Some OSes limit the range of file descriptors in a FILE*, for
21 * example to fit in "char".)
23 typedef struct FileBuf FBFILE;
26 * open a file and return a FBFILE*, see fopen(3)
28 extern FBFILE *fbopen(const char *filename, const char *mode);
30 * associate a file descriptor with a FBFILE*
31 * if a FBFILE* is associated here it MUST be closed using fbclose
34 extern FBFILE *fdbopen(int fd, const char *mode);
36 * close a file opened with fbopen, see fclose(3)
38 extern void fbclose(FBFILE * fb);
40 * return the next character from the file, EOF on end of file
43 extern int fbgetc(FBFILE * fb);
45 * return next string in a file up to and including the newline character
48 extern char *fbgets(char *buf, size_t len, FBFILE * fb);
50 * write a null terminated string to a file, see fputs(3)
52 extern int fbputs(const char *str, FBFILE * fb);
54 * return the status of the file associated with fb, see fstat(3)
56 extern int fbstat(struct stat *sb, FBFILE * fb);
58 #endif /* INCLUDED_fileio_h */