// This may look like C code, but it is really -*- C++ -*- /* Copyright (C) 1988 Free Software Foundation written by Doug Lea (dl@rocky.oswego.edu) de-eunuchs-ified for the Atari ST by JRD. This file is part of GNU CC. GNU CC is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. No author or distributor accepts responsibility to anyone for the consequences of using it or for whether it serves any particular purpose or works at all, unless he says so in writing. Refer to the GNU CC General Public License for full details. Everyone is granted permission to copy, modify and redistribute GNU CC, but only under the conditions described in the GNU CC General Public License. A copy of this license is supposed to have been given to you along with GNU CC so you can know your rights and responsibilities. It should be in a file named COPYING. Among other things, the copyright notice and this notice must be preserved on all copies. */ #ifndef _File_h #pragma once #define _File_h 1 #include #include #include enum io_mode // known unix file IO modes { io_readonly = 0, io_writeonly = 1, io_readwrite = 2, io_appendonly = 3, io_append = 4, // append, plus allow reads }; enum access_mode // ways to open a file { a_createonly = 0, // create, fail if file exists a_create = 1, // create if doesn't exist, else truncate a_useonly = 2, // use (no truncate) fail if doesn't exist a_use = 3, // use (no truncate), create if doesn't exist }; enum state_value // File states { _good = 0, // all is well _eof = 1, // at eof _fail = 2, // logical or physical IO error _bad = 4 // unopened/corrupted }; // Stuff added for ST version by jrd // // values passable to setbuf method #define UNBUFFERED 0 #define BUFFERED 1 typedef int bufferedness_t; class File { protected: FILE* fp; // struct streamoid file pointer char* nm; // file name (dynamically allocated) char rw; // 1 = read; 2 = write; 3 = readwrite // bit 2 (4) means read/write into string state_value state; // _good/_eof/_fail/_bad long stat; // last read/write/... return value void initialize(); void reinitialize(const char*); char *readline (int chunk_number, char terminator); public: File(); File(const char* filename, io_mode m, access_mode a); File(const char* filename, const char* m); File(int filedesc, io_mode m); File(FILE* fileptr); File(int sz, char* buf, io_mode m); ~File(); // binding, rebinding, unbinding to physical files File& open(const char* filename, io_mode m, access_mode a); File& open(const char* filename, const char* m); File& open(int filedesc, io_mode m); File& open(FILE* fileptr); File& close(); File& remove(); // class variable access int filedesc(); const char* name(); void setname(const char* newname); int iocount(); int rdstate(); int eof(); int fail(); int bad(); int good(); // other status queries int readable(); int writable(); int is_open(); void* operator void*(); // error handling void error(); void clear(state_value f = 0); // poorly named File& failif(int cond); void check_state(); // character IO File& get(char& c); File& put(char c); File& unget(char c); File& putback(char c); // a synonym for unget // char* IO File& put(const char* s); File& get (char* s, int n, char terminator = '\n'); File& getline(char* s, int n, char terminator = '\n'); File& gets (char **s, char terminator = '\n'); // binary IO File& read(void* x, int sz, int n); File& write(void* x, int sz, int n); // file control File& seek(long pos, int seek_mode=0); // default seek mode=absolute long tell(); File& flush(); File& setbuf(bufferedness_t buffer_kind); // legal vals: UNBUFFERED, BUFFERED File& setbuf(int size, char* buf); File& raw(); }; // error handlers extern void verbose_File_error_handler(char*); extern void quiet_File_error_handler(char*); extern void fatal_File_error_handler(char*); extern one_arg_error_handler_t File_error_handler; extern one_arg_error_handler_t set_File_error_handler(one_arg_error_handler_t); //#ifdef __OPTIMIZE__ inline int File::filedesc() { return fileno(fp); } inline const char* File::name() { return nm; } inline int File::iocount() { return stat; } inline int File::readable() { if (fp != 0) { if (feof(fp)) state |= _eof; if (ferror(fp)) state |= _bad;} return (state == _good && (rw & 01)); } inline int File::writable() { if (fp != 0 && ferror(fp)) state |= _bad; return ((state & (_fail|_bad)) == 0 && (rw & 02)); } inline int File::is_open() { return (fp != 0); } inline void File::clear(state_value flag = 0) { state = flag; } inline File& File::raw() { return this->File::setbuf(UNBUFFERED); } inline void File::check_state() // ensure fp & state agree about eof { if (fp != 0) { if (feof(fp)) state |= _eof; else state &= ~_eof; if (ferror(fp)) state |= _bad; } } inline File& File::failif(int cond) { if (cond) state |= _fail; return *this; } inline File& File::get(char& c) { if (readable()) { int ch = getc(fp); c = ch; failif (ch == EOF); } return *this; } inline File& File::put(char c) { return failif (!writable() || putc(c, fp) == EOF); } inline File& File::unget(char c) { return failif(!is_open() || !(rw & 01) || ungetc(c, fp) == EOF); } inline File& File::putback(char c) { return failif (!is_open() || !(rw & 01) || ungetc(c, fp) == EOF); } inline File& File::read(void* x, int sz, int n) { return failif (!readable() || (stat = fread(x, sz, n, fp)) != n); } inline File& File::write(void* x, int sz, int n) { return failif (!writable() || (stat = fwrite(x, sz, n, fp)) != n); } inline File& File::flush() { return failif(!is_open() || fflush(fp) == EOF); } inline File& File::seek(long pos, int seek_mode = 0) { return failif (!is_open() || fseek(fp, pos, seek_mode) < 0); } inline long File::tell() { failif (!is_open() || (stat = ftell(fp) < 0)); return stat; } inline int File::rdstate() { check_state(); return state; // check_state is necessary in rare but } // possible circumstances inline void* File::operator void*() { check_state(); return (state & (_bad|_fail))? 0 : this ; } inline int File::eof() { check_state(); return state & _eof; } inline int File::fail() { check_state(); return state & _fail; } inline int File::bad() { check_state(); return state & _bad; } inline int File::good() { check_state(); return rdstate() == _good; } //#endif #endif