1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: "wxWindows stream" base classes
4 // Author: Guilhem Lavaux
8 // Copyright: (c) Guilhem Lavaux
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_WXSTREAM_H__
13 #define _WX_WXSTREAM_H__
24 #include "wx/object.h"
25 #include "wx/string.h"
26 #include "wx/filefn.h" // for off_t, wxInvalidOffset and wxSeekMode
28 class WXDLLEXPORT wxStreamBase
;
29 class WXDLLEXPORT wxInputStream
;
30 class WXDLLEXPORT wxOutputStream
;
32 typedef wxInputStream
& (*__wxInputManip
)(wxInputStream
&);
33 typedef wxOutputStream
& (*__wxOutputManip
)(wxOutputStream
&);
35 WXDLLEXPORT wxOutputStream
& wxEndL(wxOutputStream
& o_stream
);
37 // ---------------------------------------------------------------------------
38 // wxStream: base classes
39 // ---------------------------------------------------------------------------
41 #define wxStream_NOERROR wxSTREAM_NOERROR
42 #define wxStream_EOF wxSTREAM_EOF
43 #define wxStream_WRITE_ERR wxSTREAM_WRITE_ERROR
44 #define wxStream_READ_ERR wxSTREAM_READ_ERROR
53 class WXDLLEXPORT wxStreamBase
{
56 virtual ~wxStreamBase();
58 bool operator!() const { return (LastError() != wxSTREAM_NOERROR
); }
59 wxStreamError
LastError() const { return m_lasterror
; }
60 virtual size_t GetSize() const { return ~((size_t)0); }
61 size_t StreamSize() const { return GetSize(); }
65 virtual size_t OnSysRead(void *buffer
, size_t bufsize
);
66 virtual size_t OnSysWrite(const void *buffer
, size_t bufsize
);
67 virtual off_t
OnSysSeek(off_t seek
, wxSeekMode mode
);
68 virtual off_t
OnSysTell() const;
71 friend class wxStreamBuffer
;
74 wxStreamError m_lasterror
;
77 class WXDLLEXPORT wxInputStream
: public wxStreamBase
{
80 virtual ~wxInputStream();
85 virtual wxInputStream
& Read(void *buffer
, size_t size
);
86 wxInputStream
& Read(wxOutputStream
& stream_out
);
89 virtual off_t
SeekI(off_t pos
, wxSeekMode mode
= wxFromStart
);
90 virtual off_t
TellI() const;
93 virtual size_t LastRead() { return wxStreamBase::m_lastcount
; }
96 size_t Ungetch(void *buffer
, size_t size
);
100 wxInputStream
& operator>>(wxOutputStream
& out
) { return Read(out
); }
102 wxInputStream
& operator>>(wxObject
*& obj
);
104 wxInputStream
& operator>>( __wxInputManip func
) { return func(*this); }
112 char *AllocSpaceWBack(size_t needed_size
);
113 size_t GetWBack(char *buf
, size_t bsize
);
117 class WXDLLEXPORT wxOutputStream
: public wxStreamBase
{
120 virtual ~wxOutputStream();
122 virtual wxOutputStream
& Write(const void *buffer
, size_t size
);
123 wxOutputStream
& Write(wxInputStream
& stream_in
);
125 virtual off_t
SeekO(off_t pos
, wxSeekMode mode
= wxFromStart
);
126 virtual off_t
TellO() const;
128 virtual size_t LastWrite() const { return wxStreamBase::m_lastcount
; }
132 wxOutputStream
& operator<<(wxInputStream
& out
) { return Write(out
); }
134 wxOutputStream
& operator<<(wxObject
& obj
);
136 wxOutputStream
& operator<<( __wxOutputManip func
) { return func(*this); }
139 // ---------------------------------------------------------------------------
141 // ---------------------------------------------------------------------------
143 class WXDLLEXPORT wxFilterInputStream
: public wxInputStream
{
145 wxFilterInputStream();
146 wxFilterInputStream(wxInputStream
& stream
);
147 ~wxFilterInputStream();
149 char Peek() { return m_parent_i_stream
->Peek(); }
151 wxStreamError
LastError() const { return m_parent_i_stream
->LastError(); }
152 size_t GetSize() const { return m_parent_i_stream
->GetSize(); }
155 wxInputStream
*m_parent_i_stream
;
158 class WXDLLEXPORT wxFilterOutputStream
: public wxOutputStream
{
160 wxFilterOutputStream();
161 wxFilterOutputStream(wxOutputStream
& stream
);
162 ~wxFilterOutputStream();
164 wxStreamError
LastError() const { return m_parent_o_stream
->LastError(); }
165 size_t GetSize() const { return m_parent_o_stream
->GetSize(); }
168 wxOutputStream
*m_parent_o_stream
;
171 // ---------------------------------------------------------------------------
173 // ---------------------------------------------------------------------------
175 class WXDLLEXPORT wxStreamBuffer
{
178 read
= 0, write
, read_write
184 wxStreamBuffer(wxStreamBase
& stream
, BufMode mode
);
185 wxStreamBuffer(BufMode mode
);
186 wxStreamBuffer(const wxStreamBuffer
& buf
);
192 size_t Read(void *buffer
, size_t size
);
193 size_t Read(wxStreamBuffer
*buf
);
194 size_t Write(const void *buffer
, size_t size
);
195 size_t Write(wxStreamBuffer
*buf
);
198 void PutChar(char c
);
200 off_t
Seek(off_t pos
, wxSeekMode mode
);
206 void SetBufferIO(char *buffer_start
, char *buffer_end
);
207 void SetBufferIO(size_t bufsize
);
208 char *GetBufferStart() const { return m_buffer_start
; }
209 char *GetBufferEnd() const { return m_buffer_end
; }
210 char *GetBufferPos() const { return m_buffer_pos
; }
211 off_t
GetIntPosition() const { return m_buffer_pos
-m_buffer_start
; }
212 void SetIntPosition(off_t pos
) { m_buffer_pos
= m_buffer_start
+pos
; }
213 size_t GetLastAccess() const { return m_buffer_end
-m_buffer_start
; }
215 void Fixed(bool fixed
) { m_fixed
= fixed
; }
216 void Flushable(bool f
) { m_flushable
= f
; }
220 size_t GetDataLeft();
225 wxStreamBase
*Stream() { return m_stream
; }
228 void GetFromBuffer(void *buffer
, size_t size
);
229 void PutToBuffer(const void *buffer
, size_t size
);
232 char *m_buffer_start
, *m_buffer_end
, *m_buffer_pos
;
233 size_t m_buffer_size
;
236 size_t m_wbacksize
, m_wbackcur
;
238 bool m_fixed
, m_flushable
;
240 wxStreamBase
*m_stream
;
242 bool m_destroybuf
, m_destroystream
;
245 // ---------------------------------------------------------------------------
247 // ---------------------------------------------------------------------------
249 class wxBufferedInputStream
: public wxFilterInputStream
{
251 wxBufferedInputStream(wxInputStream
& stream
);
252 ~wxBufferedInputStream();
254 wxInputStream
& Read(void *buffer
, size_t size
);
256 // Position functions
257 off_t
SeekI(off_t pos
, wxSeekMode mode
= wxFromStart
);
260 wxStreamBuffer
*InputStreamBuffer() const { return m_i_streambuf
; }
263 size_t OnSysRead(void *buffer
, size_t bufsize
);
264 off_t
OnSysSeek(off_t seek
, wxSeekMode mode
);
265 off_t
OnSysTell() const;
268 wxStreamBuffer
*m_i_streambuf
;
271 class wxBufferedOutputStream
: public wxFilterOutputStream
{
273 wxBufferedOutputStream(wxOutputStream
& stream
);
274 ~wxBufferedOutputStream();
276 wxOutputStream
& Write(const void *buffer
, size_t size
);
278 // Position functions
279 off_t
SeekO(off_t pos
, wxSeekMode mode
= wxFromStart
);
284 wxStreamBuffer
*OutputStreamBuffer() const { return m_o_streambuf
; }
287 size_t OnSysWrite(const void *buffer
, size_t bufsize
);
288 off_t
OnSysSeek(off_t seek
, wxSeekMode mode
);
289 off_t
OnSysTell() const;
292 wxStreamBuffer
*m_o_streambuf
;