home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / libg++-2.7.1-bin.lha / lib / g++-include / streambuf.h < prev    next >
C/C++ Source or Header  |  1996-10-12  |  17KB  |  474 lines
  1. /* This is part of libio/iostream, providing -*- C++ -*- input/output.
  2. Copyright (C) 1993 Free Software Foundation
  3.  
  4. This file is part of the GNU IO Library.  This library is free
  5. software; you can redistribute it and/or modify it under the
  6. terms of the GNU General Public License as published by the
  7. Free Software Foundation; either version 2, or (at your option)
  8. any later version.
  9.  
  10. This library is distributed in the hope that it will be useful,
  11. but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13. GNU General Public License for more details.
  14.  
  15. You should have received a copy of the GNU General Public License
  16. along with this library; see the file COPYING.  If not, write to the Free
  17. Software Foundation, 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  18.  
  19. As a special exception, if you link this library with files
  20. compiled with a GNU compiler to produce an executable, this does not cause
  21. the resulting executable to be covered by the GNU General Public License.
  22. This exception does not however invalidate any other reasons why
  23. the executable file might be covered by the GNU General Public License. */
  24.  
  25. #ifndef _STREAMBUF_H
  26. #define _STREAMBUF_H
  27. #ifdef __GNUG__
  28. #pragma interface
  29. #endif
  30.  
  31. /* #define _G_IO_THROW */ /* Not implemented:  ios::failure */
  32.  
  33. #define _IO_NEW_STREAMS // new optimizated stream representation
  34.  
  35. extern "C" {
  36. #include <libio.h>
  37. }
  38. //#include <_G_config.h>
  39. #ifdef _IO_NEED_STDARG_H
  40. #include <stdarg.h>
  41. #endif
  42. #ifndef _IO_va_list
  43. #define _IO_va_list char *
  44. #endif
  45.  
  46. #ifndef EOF
  47. #define EOF (-1)
  48. #endif
  49. #ifndef NULL
  50. #ifdef __GNUC__
  51. #define NULL ((void*)0)
  52. #else
  53. #define NULL (0)
  54. #endif
  55. #endif
  56.  
  57. #ifndef _IO_wchar_t
  58. #define _IO_wchar_t short
  59. #endif
  60.  
  61. extern "C++" {
  62. class istream; /* Work-around for a g++ name mangling bug. Fixed in 2.6. */
  63. class ostream; class streambuf;
  64.  
  65. // In case some header files defines these as macros.
  66. #undef open
  67. #undef close
  68.  
  69. typedef _IO_off_t streamoff;
  70. typedef _IO_fpos_t streampos;
  71. typedef _IO_ssize_t streamsize;
  72.  
  73. typedef unsigned long __fmtflags;
  74. typedef unsigned char __iostate;
  75.  
  76. struct _ios_fields
  77. { // The data members of an ios.
  78.     streambuf *_strbuf;
  79.     ostream* _tie;
  80.     int _width;
  81.     __fmtflags _flags;
  82.     _IO_wchar_t _fill;
  83.     __iostate _state;
  84.     __iostate _exceptions;
  85.     int _precision;
  86.  
  87.     void *_arrays; /* Support for ios::iword and ios::pword. */
  88. };
  89.  
  90. #define _IOS_GOOD    0
  91. #define _IOS_EOF    1
  92. #define _IOS_FAIL    2
  93. #define _IOS_BAD    4
  94.  
  95. #define _IO_INPUT    1
  96. #define _IO_OUTPUT    2
  97. #define _IO_ATEND    4
  98. #define _IO_APPEND    8
  99. #define _IO_TRUNC    16
  100. #define _IO_NOCREATE    32
  101. #define _IO_NOREPLACE    64
  102. #define _IO_BIN        128
  103.  
  104. #ifdef _STREAM_COMPAT
  105. enum state_value {
  106.     _good = _IOS_GOOD,
  107.     _eof = _IOS_EOF,
  108.     _fail = _IOS_FAIL,
  109.     _bad = _IOS_BAD };
  110. enum open_mode {
  111.     input = _IO_INPUT,
  112.     output = _IO_OUTPUT,
  113.     atend = _IO_ATEND,
  114.     append = _IO_APPEND };
  115. #endif
  116.  
  117. class ios : public _ios_fields {
  118.   ios& operator=(ios&);  /* Not allowed! */
  119.   public:
  120.     typedef __fmtflags fmtflags;
  121.     typedef int iostate;
  122.     typedef int openmode;
  123.     typedef int streamsize;
  124.     enum io_state {
  125.     goodbit = _IOS_GOOD,
  126.     eofbit = _IOS_EOF,
  127.     failbit = _IOS_FAIL,
  128.     badbit = _IOS_BAD };
  129.     enum open_mode {
  130.     in = _IO_INPUT,
  131.     out = _IO_OUTPUT,
  132.     ate = _IO_ATEND,
  133.     app = _IO_APPEND,
  134.     trunc = _IO_TRUNC,
  135.     nocreate = _IO_NOCREATE,
  136.     noreplace = _IO_NOREPLACE,
  137.     bin = _IOS_BIN };
  138.     enum seek_dir { beg, cur, end};
  139.     // ANSI: typedef enum seek_dir seekdir; etc
  140.     // NOTE: If adding flags here, before to update ios::bitalloc().
  141.     enum { skipws=_IO_SKIPWS,
  142.        left=_IO_LEFT, right=_IO_RIGHT, internal=_IO_INTERNAL,
  143.        dec=_IO_DEC, oct=_IO_OCT, hex=_IO_HEX,
  144.        showbase=_IO_SHOWBASE, showpoint=_IO_SHOWPOINT,
  145.        uppercase=_IO_UPPERCASE, showpos=_IO_SHOWPOS,
  146.        scientific=_IO_SCIENTIFIC, fixed=_IO_FIXED,
  147.        unitbuf=_IO_UNITBUF, stdio=_IO_STDIO
  148. #ifndef _IO_NEW_STREAMS
  149.        , dont_close=_IO_DONT_CLOSE // Don't delete streambuf on stream destruction
  150. #endif
  151.        };
  152.     enum { // Masks.
  153.     basefield=dec+oct+hex,
  154.     floatfield = scientific+fixed,
  155.     adjustfield = left+right+internal
  156.     };
  157.  
  158. #ifdef _IO_THROW
  159.     class failure : public xmsg {
  160.     ios* _stream;
  161.       public:
  162.     failure(ios* stream) { _stream = stream; }
  163.     failure(string cause, ios* stream) { _stream = stream; }
  164.     ios* rdios() const { return _stream; }
  165.     };
  166. #endif
  167.  
  168.     ostream* tie() const { return _tie; }
  169.     ostream* tie(ostream* val) { ostream* save=_tie; _tie=val; return save; }
  170.  
  171.     // Methods to change the format state.
  172.     _IO_wchar_t fill() const { return (_IO_wchar_t)_fill; }
  173.     _IO_wchar_t fill(_IO_wchar_t newf)
  174.     {_IO_wchar_t oldf = (_IO_wchar_t)_fill; _fill = (char)newf; return oldf;}
  175.     fmtflags flags() const { return _flags; }
  176.     fmtflags flags(fmtflags new_val) {
  177.     fmtflags old_val = _flags; _flags = new_val; return old_val; }
  178.     int precision() const { return _precision; }
  179.     int precision(int newp) {
  180.     unsigned short oldp = _precision; _precision = (unsigned short)newp;
  181.     return oldp; }
  182.     fmtflags setf(fmtflags val) {
  183.     fmtflags oldbits = _flags;
  184.     _flags |= val; return oldbits; }
  185.     fmtflags setf(fmtflags val, fmtflags mask) {
  186.     fmtflags oldbits = _flags;
  187.     _flags = (_flags & ~mask) | (val & mask); return oldbits; }
  188.     fmtflags unsetf(fmtflags mask) {
  189.     fmtflags oldbits = _flags;
  190.     _flags &= ~mask; return oldbits; }
  191.     int width() const { return _width; }
  192.     int width(int val) { int save = _width; _width = val; return save; }
  193.  
  194. #ifdef _IO_THROW
  195.     void _throw_failure() const { throw new ios::failure(this); }
  196. #else
  197.     void _throw_failure() const { }
  198. #endif
  199.     void clear(iostate state = 0) {
  200.     _state = _strbuf ? state : state|badbit;
  201.     if (_state & _exceptions) _throw_failure(); }
  202.     void set(iostate flag) { _state |= flag;
  203.     if (_state & _exceptions) _throw_failure(); }
  204.     void setstate(iostate flag) { _state |= flag; // ANSI
  205.     if (_state & _exceptions) _throw_failure(); }
  206.     int good() const { return _state == 0; }
  207.     int eof() const { return _state & ios::eofbit; }
  208.     int fail() const { return _state & (ios::badbit|ios::failbit); }
  209.     int bad() const { return _state & ios::badbit; }
  210.     iostate rdstate() const { return _state; }
  211.     operator void*() const { return fail() ? (void*)0 : (void*)(-1); }
  212.     int operator!() const { return fail(); }
  213.     iostate exceptions() const { return _exceptions; }
  214.     void exceptions(iostate enable) {
  215.     _exceptions = enable;
  216.     if (_state & _exceptions) _throw_failure(); }
  217.  
  218.     streambuf* rdbuf() const { return _strbuf; }
  219.     streambuf* rdbuf(streambuf *_s) {
  220.       streambuf *_old = _strbuf; _strbuf = _s; clear (); return _old; }
  221.  
  222.     static int sync_with_stdio(int on);
  223.     static void sync_with_stdio() { sync_with_stdio(1); }
  224.     static fmtflags bitalloc();
  225.     static int xalloc();
  226.     void*& pword(int);
  227.     void* pword(int) const;
  228.     long& iword(int);
  229.     long iword(int) const;
  230.  
  231. #ifdef _STREAM_COMPAT
  232.     void unset(state_value flag) { _state &= ~flag; }
  233.     void close();
  234.     int is_open();
  235.     int readable();
  236.     int writable();
  237. #endif
  238.  
  239.     // Used to initialize standard streams. Not needed in this implementation.
  240.     class Init {
  241.     public:
  242.       Init () { }
  243.     };
  244.  
  245.   protected:
  246.     inline ios(streambuf* sb = 0, ostream* tie_to = 0);
  247.     inline virtual ~ios();
  248.     inline void init(streambuf* sb, ostream* tie = 0);
  249. };
  250.  
  251. #if __GNUG__==1
  252. typedef int _seek_dir;
  253. #else
  254. typedef ios::seek_dir _seek_dir;
  255. #endif
  256.  
  257. // Magic numbers and bits for the _flags field.
  258. // The magic numbers use the high-order bits of _flags;
  259. // the remaining bits are abailable for variable flags.
  260. // Note: The magic numbers must all be negative if stdio
  261. // emulation is desired.
  262.  
  263. // A streammarker remembers a position in a buffer.
  264. // You are guaranteed to be able to seek back to it if it is saving().
  265. class streammarker : private _IO_marker {
  266.     friend class streambuf;
  267.     void set_offset(int offset) { _pos = offset; }
  268.   public:
  269.     streammarker(streambuf *sb);
  270.     ~streammarker();
  271.     int saving() { return  1; }
  272.     int delta(streammarker&);
  273.     int delta();
  274. };
  275.  
  276. struct streambuf : public _IO_FILE { // protected??
  277.     friend class ios;
  278.     friend class istream;
  279.     friend class ostream;
  280.     friend class streammarker;
  281.     const void *&_vtable() { return *(const void**)((_IO_FILE*)this + 1); }
  282.   protected:
  283.     static streambuf* _list_all; /* List of open streambufs. */
  284.     _IO_FILE*& xchain() { return _chain; }
  285.     void _un_link();
  286.     void _link_in();
  287.     char* gptr() const
  288.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_base : _IO_read_ptr; }
  289.     char* pptr() const { return _IO_write_ptr; }
  290.     char* egptr() const
  291.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_end : _IO_read_end; }
  292.     char* epptr() const { return _IO_write_end; }
  293.     char* pbase() const { return _IO_write_base; }
  294.     char* eback() const
  295.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_base : _IO_read_base;}
  296.     char* base() const { return _IO_buf_base; }
  297.     char* ebuf() const { return _IO_buf_end; }
  298.     int blen() const { return _IO_buf_end - _IO_buf_base; }
  299.     void xput_char(char c) { *_IO_write_ptr++ = c; }
  300.     int xflags() { return _IO_file_flags; }
  301.     int xflags(int f) {int fl = _IO_file_flags; _IO_file_flags = f; return fl;}
  302.     void xsetflags(int f) { _IO_file_flags |= f; }
  303.     void xsetflags(int f, int mask)
  304.       { _IO_file_flags = (_IO_file_flags & ~mask) | (f & mask); }
  305.     void gbump(int n)
  306.       { _IO_file_flags & _IO_IN_BACKUP ? (_IO_save_base+=n):(_IO_read_ptr+=n);}
  307.     void pbump(int n) { _IO_write_ptr += n; }
  308.     void setb(char* b, char* eb, int a=0);
  309.     void setp(char* p, char* ep)
  310.       { _IO_write_base=_IO_write_ptr=p; _IO_write_end=ep; }
  311.     void setg(char* eb, char* g, char *eg) {
  312.       if (_IO_file_flags & _IO_IN_BACKUP) _IO_free_backup_area(this); 
  313.       _IO_read_base = eb; _IO_read_ptr = g; _IO_read_end = eg; }
  314.     char *shortbuf() { return _shortbuf; }
  315.  
  316.     int in_backup() { return _flags & _IO_IN_BACKUP; }
  317.     // The start of the main get area:  FIXME:  wrong for write-mode filebuf?
  318.     char *Gbase() { return in_backup() ? _IO_save_base : _IO_read_base; }
  319.     // The end of the main get area:
  320.     char *eGptr() { return in_backup() ? _IO_save_end : _IO_read_end; }
  321.     // The start of the backup area:
  322.     char *Bbase() { return in_backup() ? _IO_read_base : _IO_save_base; }
  323.     char *Bptr() { return _IO_backup_base; }
  324.     // The end of the backup area:
  325.     char *eBptr() { return in_backup() ? _IO_read_end : _IO_save_end; }
  326.     char *Nbase() { return _IO_save_base; }
  327.     char *eNptr() { return _IO_save_end; }
  328.     int have_backup() { return _IO_save_base != NULL; }
  329.     int have_markers() { return _markers != NULL; }
  330.     void free_backup_area();
  331.     void unsave_markers(); // Make all streammarkers !saving().
  332.     int put_mode() { return _flags & _IO_CURRENTLY_PUTTING; }
  333.     int switch_to_get_mode();
  334.     
  335.     streambuf(int flags=0);
  336.   public:
  337.     static int flush_all();
  338.     static void flush_all_linebuffered(); // Flush all line buffered files.
  339.     virtual ~streambuf();
  340.     virtual int overflow(int c = EOF); // Leave public for now
  341.     virtual int underflow(); // Leave public for now
  342.     virtual int uflow(); // Leave public for now
  343.     virtual int pbackfail(int c);
  344. //    virtual int showmany ();
  345.     virtual streamsize xsputn(const char* s, streamsize n);
  346.     virtual streamsize xsgetn(char* s, streamsize n);
  347.     virtual streampos seekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  348.     virtual streampos seekpos(streampos pos, int mode = ios::in|ios::out);
  349.  
  350.     streampos pubseekoff(streamoff o, _seek_dir d, int mode=ios::in|ios::out)
  351.       { return _IO_seekoff (this, o, d, mode); }
  352.     streampos pubseekpos(streampos pos, int mode = ios::in|ios::out)
  353.       { return _IO_seekpos (this, pos, mode); }
  354.     streampos sseekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  355.     streampos sseekpos(streampos pos, int mode = ios::in|ios::out);
  356.     virtual streambuf* setbuf(char* p, int len);
  357.     virtual int sync();
  358.     virtual int doallocate();
  359.  
  360.     int seekmark(streammarker& mark, int delta = 0);
  361.     int sputbackc(char c);
  362.     int sungetc();
  363.     int unbuffered() { return _flags & _IO_UNBUFFERED ? 1 : 0; }
  364.     int linebuffered() { return _flags & _IO_LINE_BUF ? 1 : 0; }
  365.     void unbuffered(int i)
  366.     { if (i) _flags |= _IO_UNBUFFERED; else _flags &= ~_IO_UNBUFFERED; }
  367.     void linebuffered(int i)
  368.     { if (i) _flags |= _IO_LINE_BUF; else _flags &= ~_IO_LINE_BUF; }
  369.     int allocate() { // For AT&T compatibility
  370.     if (base() || unbuffered()) return 0;
  371.     else return doallocate(); }
  372.     // Allocate a buffer if needed; use _shortbuf if appropriate.
  373.     void allocbuf() { if (base() == NULL) doallocbuf(); }
  374.     void doallocbuf();
  375.     int in_avail() { return _IO_read_end - _IO_read_ptr; }
  376.     int out_waiting() { return _IO_write_ptr - _IO_write_base; }
  377.     streamsize sputn(const char* s, streamsize n) { return xsputn(s, n); }
  378.     streamsize padn(char pad, streamsize n) { return _IO_padn(this, pad, n); }
  379.     streamsize sgetn(char* s, streamsize n) { return _IO_sgetn(this, s, n); }
  380.     int ignore(int);
  381.     int get_column();
  382.     int set_column(int);
  383.     long sgetline(char* buf, _IO_size_t n, char delim, int putback_delim);
  384.     int sputc(int c) { return _IO_putc(c, this); }
  385.     int sbumpc() { return _IO_getc(this); }
  386.     int sgetc() { return _IO_peekc(this); }
  387.     int snextc() {
  388.     if (_IO_read_ptr >= _IO_read_end && __underflow(this) == EOF)
  389.       return EOF;
  390.     else return _IO_read_ptr++, sgetc(); }
  391.     void stossc() { if (_IO_read_ptr < _IO_read_end) _IO_read_ptr++; }
  392.     int vscan(char const *fmt0, _IO_va_list ap, ios* stream = NULL);
  393.     int scan(char const *fmt0 ...);
  394.     int vform(char const *fmt0, _IO_va_list ap);
  395.     int form(char const *fmt0 ...);
  396. #if 0 /* Work in progress */
  397.     int column();  // Current column number (of put pointer). -1 is unknown.
  398.     void column(int c);  // Set column number of put pointer to c.
  399. #endif
  400.     virtual streamsize sys_read(char* buf, streamsize size);
  401.     virtual streamsize sys_write(const char*, streamsize);
  402.     virtual streampos sys_seek(streamoff, _seek_dir);
  403.     virtual int sys_close();
  404.     virtual int sys_stat(void*); // Actually, a (struct stat*)
  405. };
  406.  
  407. // A backupbuf is a streambuf with full backup and savepoints on reading.
  408. // All standard streambufs in the GNU iostream library are backupbufs.
  409.  
  410. class filebuf : public streambuf {
  411.   protected:
  412.     void init();
  413.   public:
  414.     static const int openprot; // Non-ANSI AT&T-ism:  Default open protection.
  415.     filebuf();
  416.     filebuf(int fd);
  417.     filebuf(int fd, char* p, int len);
  418. #if !_IO_UNIFIED_JUMPTABLES
  419.     static filebuf *__new();
  420. #endif
  421.     ~filebuf();
  422.     filebuf* attach(int fd);
  423.     filebuf* open(const char *filename, const char *mode);
  424.     filebuf* open(const char *filename, ios::openmode mode, int prot = 0664);
  425.     virtual int underflow();
  426.     virtual int overflow(int c = EOF);
  427.     int is_open() const { return _fileno >= 0; }
  428.     int fd() const { return is_open() ? _fileno : EOF; }
  429.     filebuf* close();
  430.     virtual int doallocate();
  431.     virtual streampos seekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  432.     virtual streambuf* setbuf(char* p, int len);
  433.     streamsize xsputn(const char* s, streamsize n);
  434.     streamsize xsgetn(char* s, streamsize n);
  435.     virtual int sync();
  436.   protected: // See documentation in filebuf.C.
  437. //    virtual int pbackfail(int c);
  438.     int is_reading() { return eback() != egptr(); }
  439.     char* cur_ptr() { return is_reading() ?  gptr() : pptr(); }
  440.     /* System's idea of pointer */
  441.     char* file_ptr() { return eGptr(); }
  442.     // Low-level operations (Usually invoke system calls.)
  443.     virtual streamsize sys_read(char* buf, streamsize size);
  444.     virtual streampos sys_seek(streamoff, _seek_dir);
  445.     virtual streamsize sys_write(const char*, streamsize);
  446.     virtual int sys_stat(void*); // Actually, a (struct stat*)
  447.     virtual int sys_close();
  448. #if 0
  449.     virtual uflow;
  450.     virtual showmany;
  451. #endif
  452. };
  453.  
  454. inline void ios::init(streambuf* sb, ostream* tie_to) {
  455.         _state = sb ? ios::goodbit : ios::badbit; _exceptions=0;
  456.         _strbuf=sb; _tie = tie_to; _width=0; _fill=' ';
  457. #ifdef _IO_NEW_STREAMS
  458.         _flags=ios::skipws|ios::dec;
  459. #else
  460.         _flags=ios::skipws|ios::dec|ios::dont_close;
  461. #endif
  462.         _precision=6; _arrays = 0; }
  463.  
  464. inline ios::ios(streambuf* sb, ostream* tie_to) { init(sb, tie_to); }
  465.  
  466. inline ios::~ios() {
  467. #ifndef _IO_NEW_STREAMS
  468.     if (!(_flags & (unsigned int)ios::dont_close)) delete rdbuf();
  469. #endif
  470.     if (_arrays) delete [] _arrays;
  471. }
  472. } // extern "C++"
  473. #endif /* _STREAMBUF_H */
  474.