2002-01-14 11:40:44 -05:00
|
|
|
\section{\class{wxDataOutputStream}}\label{wxdataoutputstream}
|
|
|
|
|
|
|
|
This class provides functions that write binary data types in a
|
2002-06-07 16:15:28 -04:00
|
|
|
portable way. Data can be written in either big-endian or little-endian
|
2002-01-14 11:40:44 -05:00
|
|
|
format, little-endian being the default on all architectures.
|
|
|
|
|
|
|
|
If you want to write data to text files (or streams) use
|
|
|
|
\helpref{wxTextOutputStream}{wxtextoutputstream} instead.
|
|
|
|
|
|
|
|
The << operator is overloaded and you can use this class like a standard
|
|
|
|
C++ iostream. See \helpref{wxDataInputStream}{wxdatainputstream} for its
|
|
|
|
usage and caveats.
|
|
|
|
|
|
|
|
See also \helpref{wxDataInputStream}{wxdatainputstream}.
|
|
|
|
|
|
|
|
\wxheading{Derived from}
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::wxDataOutputStream}\label{wxdataoutputstreamconstr}
|
|
|
|
|
|
|
|
\func{}{wxDataOutputStream}{\param{wxOutputStream\&}{ stream}}
|
|
|
|
|
2002-07-21 18:29:08 -04:00
|
|
|
\func{}{wxDataOutputStream}{\param{wxOutputStream\&}{ stream}, \param{wxMBConv\&}{ conv = wxMBConvUTF8}}
|
|
|
|
|
2002-01-14 11:40:44 -05:00
|
|
|
Constructs a datastream object from an output stream. Only write methods will
|
2002-07-21 18:29:08 -04:00
|
|
|
be available. The second form is only available in Unicode build of wxWindows.
|
2002-01-14 11:40:44 -05:00
|
|
|
|
|
|
|
\wxheading{Parameters}
|
|
|
|
|
|
|
|
\docparam{stream}{The output stream.}
|
|
|
|
|
2002-07-21 18:29:08 -04:00
|
|
|
\docparam{conv}{Charset conversion object object used to encoding Unicode
|
|
|
|
strings before writing them to the stream
|
|
|
|
in Unicode mode (see \helpref{wxDataOutputStream::WriteString}{wxdataoutputstreamwritestring}
|
|
|
|
documentation for detailed description). Note that you must not destroy
|
|
|
|
{\it conv} before you destroy this wxDataOutputStream instance! It is
|
|
|
|
recommended to use default value (UTF-8).}
|
|
|
|
|
2002-01-14 11:40:44 -05:00
|
|
|
\membersection{wxDataOutputStream::\destruct{wxDataOutputStream}}
|
|
|
|
|
|
|
|
\func{}{\destruct{wxDataOutputStream}}{\void}
|
|
|
|
|
|
|
|
Destroys the wxDataOutputStream object.
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::BigEndianOrdered}
|
|
|
|
|
|
|
|
\func{void}{BigEndianOrdered}{\param{bool}{ be\_order}}
|
|
|
|
|
|
|
|
If {\it be\_order} is TRUE, all data will be written in big-endian
|
|
|
|
order, e.g. for reading on a Sparc or from Java-Streams (which
|
|
|
|
always use big-endian order), otherwise data will be written in
|
|
|
|
little-endian order.
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::Write8}
|
|
|
|
|
|
|
|
\func{void}{Write8}{{\param wxUint8 }{i8}}
|
|
|
|
|
|
|
|
Writes the single byte {\it i8} to the stream.
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::Write16}
|
|
|
|
|
|
|
|
\func{void}{Write16}{{\param wxUint16 }{i16}}
|
|
|
|
|
|
|
|
Writes the 16 bit integer {\it i16} to the stream.
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::Write32}
|
|
|
|
|
|
|
|
\func{void}{Write32}{{\param wxUint32 }{i32}}
|
|
|
|
|
|
|
|
Writes the 32 bit integer {\it i32} to the stream.
|
|
|
|
|
|
|
|
\membersection{wxDataOutputStream::WriteDouble}
|
|
|
|
|
|
|
|
\func{void}{WriteDouble}{{\param double }{f}}
|
|
|
|
|
|
|
|
Writes the double {\it f} to the stream using the IEEE format.
|
|
|
|
|
2002-07-21 18:29:08 -04:00
|
|
|
\membersection{wxDataOutputStream::WriteString}\label{wxdataoutputstreamwritestring}
|
|
|
|
|
|
|
|
\func{void}{WriteString}{{\param const wxString\&}{string}}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
|
|
|
|
|
|
|
Writes {\it string} to the stream. Actually, this method writes the size of
|
|
|
|
the string before writing {\it string} itself.
|
|
|
|
|
2002-07-21 18:29:08 -04:00
|
|
|
In ANSI build of wxWindows, the string is written to the stream in exactly
|
|
|
|
same way it is represented in memory. In Unicode build, however, the string
|
|
|
|
is first converted to multibyte representation with {\it conv} object passed
|
|
|
|
to stream's constructor (consequently, ANSI application can read data
|
|
|
|
written by Unicode application, as long as they agree on encoding) and this
|
|
|
|
representation is written to the stream. UTF-8 is used by default.
|