// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
-#ifndef __WXSTREAM_H__
-#define __WXSTREAM_H__
+#ifndef _WX_WXSTREAM_H__
+#define _WX_WXSTREAM_H__
#ifdef __GNUG__
#pragma interface
#endif
+#include "wx/defs.h"
+
+#if wxUSE_STREAMS
+
#include <stdio.h>
-#include <wx/object.h>
-#include <wx/string.h>
+#include "wx/object.h"
+#include "wx/string.h"
+#include "wx/filefn.h" // for off_t, wxInvalidOffset and wxSeekMode
+
+class WXDLLEXPORT wxStreamBase;
+class WXDLLEXPORT wxInputStream;
+class WXDLLEXPORT wxOutputStream;
+
+typedef wxInputStream& (*__wxInputManip)(wxInputStream&);
+typedef wxOutputStream& (*__wxOutputManip)(wxOutputStream&);
+
+WXDLLEXPORT wxOutputStream& wxEndL(wxOutputStream& o_stream);
+
+// ---------------------------------------------------------------------------
+// wxStream: base classes
+// ---------------------------------------------------------------------------
+
+typedef enum
+{
+ wxSTREAM_NO_ERROR = 0,
+ wxSTREAM_NO_ERR = wxSTREAM_NO_ERROR,
+ wxSTREAM_NOERROR = wxSTREAM_NO_ERROR,
+
+ wxSTREAM_EOF,
+
+ wxSTREAM_WRITE_ERROR,
+ wxSTREAM_WRITE_ERR = wxSTREAM_WRITE_ERROR,
+
+ wxSTREAM_READ_ERROR,
+ wxSTREAM_READ_ERR = wxSTREAM_READ_ERROR
+
+} wxStreamError;
+
+// compatibility
+#define wxStream_NOERROR wxSTREAM_NOERROR
+#define wxStream_EOF wxSTREAM_EOF
+#define wxStream_WRITE_ERR wxSTREAM_WRITE_ERROR
+#define wxStream_READ_ERR wxSTREAM_READ_ERROR
+
+class WXDLLEXPORT wxStreamBase
+{
+public:
+ wxStreamBase();
+ virtual ~wxStreamBase();
+
+ // error testing
+ wxStreamError LastError() const { return m_lasterror; }
+ wxStreamError GetLastError() const { return m_lasterror; }
+ bool IsOk() const { return LastError() == wxSTREAM_NOERROR; }
+ bool operator!() const { return LastError() != wxSTREAM_NOERROR; }
+
+ virtual size_t GetSize() const { return ~((size_t)0); }
+ size_t StreamSize() const { return GetSize(); }
+
+protected:
+ virtual size_t OnSysRead(void *buffer, size_t bufsize);
+ virtual size_t OnSysWrite(const void *buffer, size_t bufsize);
+ virtual off_t OnSysSeek(off_t seek, wxSeekMode mode);
+ virtual off_t OnSysTell() const;
+
+ friend class wxStreamBuffer;
+
+ size_t m_lastcount;
+ wxStreamError m_lasterror;
+};
+
+class WXDLLEXPORT wxInputStream: public wxStreamBase
+{
+public:
+ wxInputStream();
+ virtual ~wxInputStream();
+
+ // is the stream at EOF?
+ virtual bool Eof() const;
+
+ // IO functions
+ virtual char Peek();
+ char GetC();
+ virtual wxInputStream& Read(void *buffer, size_t size);
+ wxInputStream& Read(wxOutputStream& stream_out);
+
+ // Position functions
+ virtual off_t SeekI(off_t pos, wxSeekMode mode = wxFromStart);
+ virtual off_t TellI() const;
+
+ // State functions
+ virtual size_t LastRead() { return wxStreamBase::m_lastcount; }
+
+ // Ungetch
+ size_t Ungetch(const void *buffer, size_t size);
+ bool Ungetch(char c);
+
+ // Operators
+ wxInputStream& operator>>(wxOutputStream& out) { return Read(out); }
+#if wxUSE_SERIAL
+ wxInputStream& operator>>(wxObject *& obj);
+#endif
+ wxInputStream& operator>>( __wxInputManip func) { return func(*this); }
+
+protected:
+ // Ungetch managers
+ char *m_wback;
+ size_t m_wbacksize;
+ size_t m_wbackcur;
+
+ char *AllocSpaceWBack(size_t needed_size);
+ size_t GetWBack(char *buf, size_t bsize);
+};
+
+class WXDLLEXPORT wxOutputStream: public wxStreamBase
+{
+public:
+ wxOutputStream();
+ virtual ~wxOutputStream();
-/*
- * wxStream: base classes
- */
+ void PutC(char c);
+ virtual wxOutputStream& Write(const void *buffer, size_t size);
+ wxOutputStream& Write(wxInputStream& stream_in);
-typedef enum {
- wxFromStart, wxFromCurrent, wxFromEnd
-} wxSeekMode;
+ virtual off_t SeekO(off_t pos, wxSeekMode mode = wxFromStart);
+ virtual off_t TellO() const;
-class wxOutputStream;
-class wxInputStream: virtual public wxObject {
- DECLARE_ABSTRACT_CLASS(wxInputStream)
- public:
- wxInputStream();
- virtual ~wxInputStream();
+ virtual size_t LastWrite() const { return wxStreamBase::m_lastcount; }
- virtual wxInputStream& Read(void *buffer, size_t size) = 0;
- wxInputStream& Read(wxOutputStream& stream_out);
+ virtual void Sync();
- virtual off_t SeekI(off_t pos, wxSeekMode mode = wxFromStart) = 0;
- virtual off_t TellI() const = 0;
+ wxOutputStream& operator<<(wxInputStream& out) { return Write(out); }
+#if wxUSE_SERIAL
+ wxOutputStream& operator<<(wxObject& obj);
+#endif
+ wxOutputStream& operator<<( __wxOutputManip func) { return func(*this); }
+};
+
+// ---------------------------------------------------------------------------
+// A stream for measuring streamed output
+// ---------------------------------------------------------------------------
+
+class WXDLLEXPORT wxCountingOutputStream: public wxOutputStream
+{
+public:
+ wxCountingOutputStream();
- virtual bool Eof() const = 0;
- virtual size_t LastRead() const = 0;
+ size_t GetSize() const;
+ bool Ok() const { return TRUE; }
- wxInputStream& operator>>(wxOutputStream& out) { return Read(out); }
+protected:
+ size_t OnSysWrite(const void *buffer, size_t size);
+ off_t OnSysSeek(off_t pos, wxSeekMode mode);
+ off_t OnSysTell() const;
+
+ size_t m_currentPos;
};
-class wxOutputStream: virtual public wxObject {
- DECLARE_ABSTRACT_CLASS(wxOutputStream)
- public:
- wxOutputStream();
- virtual ~wxOutputStream();
+// ---------------------------------------------------------------------------
+// "Filter" streams
+// ---------------------------------------------------------------------------
+
+class WXDLLEXPORT wxFilterInputStream: public wxInputStream
+{
+public:
+ wxFilterInputStream();
+ wxFilterInputStream(wxInputStream& stream);
+ ~wxFilterInputStream();
+
+ char Peek() { return m_parent_i_stream->Peek(); }
+
+ size_t GetSize() const { return m_parent_i_stream->GetSize(); }
- virtual wxOutputStream& Write(const void *buffer, size_t size) = 0;
- wxOutputStream& Write(wxInputStream& stream_in);
+protected:
+ wxInputStream *m_parent_i_stream;
+};
- virtual off_t SeekO(off_t pos, wxSeekMode mode = wxFromStart) = 0;
- virtual off_t TellO() const = 0;
+class WXDLLEXPORT wxFilterOutputStream: public wxOutputStream
+{
+public:
+ wxFilterOutputStream();
+ wxFilterOutputStream(wxOutputStream& stream);
+ ~wxFilterOutputStream();
- virtual bool Bad() const = 0;
- virtual size_t LastWrite() const = 0;
+ size_t GetSize() const { return m_parent_o_stream->GetSize(); }
- virtual void Sync() {}
+protected:
+ wxOutputStream *m_parent_o_stream;
};
-/*
- * "Filter" streams
- */
+// ---------------------------------------------------------------------------
+// Stream buffer
+// ---------------------------------------------------------------------------
+
+class WXDLLEXPORT wxStreamBuffer
+{
+public:
+ typedef enum {
+ read = 0, write, read_write
+ } BufMode;
+
+ wxStreamBuffer(wxStreamBase& stream, BufMode mode);
+ wxStreamBuffer(BufMode mode);
+ wxStreamBuffer(const wxStreamBuffer& buf);
+ ~wxStreamBuffer();
+
+ // Filtered IO
+ size_t Read(void *buffer, size_t size);
+ size_t Read(wxStreamBuffer *buf);
+ size_t Write(const void *buffer, size_t size);
+ size_t Write(wxStreamBuffer *buf);
+
+ char Peek();
+ char GetChar();
+ void PutChar(char c);
+ off_t Tell() const;
+ off_t Seek(off_t pos, wxSeekMode mode);
+
+ // Buffer control
+ void ResetBuffer();
+ void SetBufferIO(char *buffer_start, char *buffer_end);
+ void SetBufferIO(size_t bufsize);
+ char *GetBufferStart() const { return m_buffer_start; }
+ char *GetBufferEnd() const { return m_buffer_end; }
+ char *GetBufferPos() const { return m_buffer_pos; }
+ off_t GetIntPosition() const { return m_buffer_pos-m_buffer_start; }
+ void SetIntPosition(off_t pos) { m_buffer_pos = m_buffer_start+pos; }
+ size_t GetLastAccess() const { return m_buffer_end-m_buffer_start; }
+
+ void Fixed(bool fixed) { m_fixed = fixed; }
+ void Flushable(bool f) { m_flushable = f; }
+
+ bool FlushBuffer();
+ bool FillBuffer();
+ size_t GetDataLeft();
-class wxFilterInputStream: public wxInputStream {
- DECLARE_CLASS(wxFilterInputStream)
- public:
- wxFilterInputStream(wxInputStream& stream);
- virtual ~wxFilterInputStream();
+ // Misc.
+ wxStreamBase *Stream() { return m_stream; }
- virtual wxInputStream& Read(void *buffer, size_t size)
- { return m_parent_i_stream->Read(buffer, size); }
- virtual off_t SeekI(off_t pos, wxSeekMode mode = wxFromStart)
- { return m_parent_i_stream->SeekI(pos, mode); }
- virtual off_t TellI() const
- { return m_parent_i_stream->TellI(); }
+protected:
+ void GetFromBuffer(void *buffer, size_t size);
+ void PutToBuffer(const void *buffer, size_t size);
- virtual bool Eof() const { return m_parent_i_stream->Eof(); }
- virtual size_t LastRead() const { return m_parent_i_stream->LastRead(); }
+ char *m_buffer_start, *m_buffer_end, *m_buffer_pos;
+ size_t m_buffer_size;
- protected:
- wxInputStream *m_parent_i_stream;
+ bool m_fixed, m_flushable;
+
+ wxStreamBase *m_stream;
+ BufMode m_mode;
+ bool m_destroybuf, m_destroystream;
};
-class wxFilterOutputStream: public wxOutputStream {
- DECLARE_CLASS(wxFilterOutputStream)
- public:
- wxFilterOutputStream(wxOutputStream& stream);
- virtual ~wxFilterOutputStream();
+// ---------------------------------------------------------------------------
+// wxBufferedStreams
+// ---------------------------------------------------------------------------
+
+class WXDLLEXPORT wxBufferedInputStream: public wxFilterInputStream
+{
+public:
+ wxBufferedInputStream(wxInputStream& stream);
+ ~wxBufferedInputStream();
+
+ char Peek();
+ wxInputStream& Read(void *buffer, size_t size);
+
+ // Position functions
+ off_t SeekI(off_t pos, wxSeekMode mode = wxFromStart);
+ off_t TellI() const;
- virtual wxOutputStream& Write(const void *buffer, size_t size)
- { return m_parent_o_stream->Write(buffer, size); }
- virtual off_t SeekO(off_t pos, wxSeekMode mode = wxFromStart)
- { return m_parent_o_stream->SeekO(pos, mode); }
- virtual off_t TellO() const
- { return m_parent_o_stream->TellO(); }
+ wxStreamBuffer *InputStreamBuffer() const { return m_i_streambuf; }
- virtual bool Bad() const { return m_parent_o_stream->Bad(); }
- virtual size_t LastWrite() const { return m_parent_o_stream->LastWrite(); }
+protected:
+ size_t OnSysRead(void *buffer, size_t bufsize);
+ off_t OnSysSeek(off_t seek, wxSeekMode mode);
+ off_t OnSysTell() const;
- protected:
- wxOutputStream *m_parent_o_stream;
+ wxStreamBuffer *m_i_streambuf;
};
+class WXDLLEXPORT wxBufferedOutputStream: public wxFilterOutputStream
+{
+public:
+ wxBufferedOutputStream(wxOutputStream& stream);
+ ~wxBufferedOutputStream();
+
+ wxOutputStream& Write(const void *buffer, size_t size);
+
+ // Position functions
+ off_t SeekO(off_t pos, wxSeekMode mode = wxFromStart);
+ off_t TellO() const;
+
+ void Sync();
+
+ size_t GetSize() const;
+
+ wxStreamBuffer *OutputStreamBuffer() const { return m_o_streambuf; }
+
+protected:
+ size_t OnSysWrite(const void *buffer, size_t bufsize);
+ off_t OnSysSeek(off_t seek, wxSeekMode mode);
+ off_t OnSysTell() const;
+
+ wxStreamBuffer *m_o_streambuf;
+};
+
+#endif
+ // wxUSE_STREAMS
+
#endif
+ // _WX_WXSTREAM_H__