## wxDataOutputStream

This class provides functions that write binary data types in a portable way. Data can be written in either big-endian or little-endian format, little-endian being the default on all architectures.

If you want to write data to text files (or streams) use wxTextOutputStream instead.

The << operator is overloaded and you can use this class like a standard C++ iostream. See wxDataInputStream for its usage and caveats.

See also wxDataInputStream.

Derived from

None

Members

wxDataOutputStream::wxDataOutputStream
wxDataOutputStream::~wxDataOutputStream
wxDataOutputStream::BigEndianOrdered
wxDataOutputStream::Write8
wxDataOutputStream::Write16
wxDataOutputStream::Write32
wxDataOutputStream::Write64
wxDataOutputStream::WriteDouble
wxDataOutputStream::WriteString

### wxDataOutputStream::wxDataOutputStream

wxDataOutputStream(wxOutputStream& stream)

wxDataOutputStream(wxOutputStream& stream, wxMBConv& conv = wxMBConvUTF8)

Constructs a datastream object from an output stream. Only write methods will be available. The second form is only available in Unicode build of wxWindows.

Parameters

stream

The output stream.

conv

Charset conversion object object used to encoding Unicode strings before writing them to the stream in Unicode mode (see wxDataOutputStream::WriteString documentation for detailed description). Note that you must not destroy conv before you destroy this wxDataOutputStream instance! It is recommended to use default value (UTF-8).

### wxDataOutputStream::~wxDataOutputStream

~wxDataOutputStream()

Destroys the wxDataOutputStream object.

### wxDataOutputStream::BigEndianOrdered

void BigEndianOrdered(bool be_order)

If 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.

### wxDataOutputStream::Write8

void Write8(wxUint8 i8)

Writes the single byte i8 to the stream.

### wxDataOutputStream::Write16

void Write16(wxUint16 i16)

Writes the 16 bit unsigned integer i16 to the stream.

### wxDataOutputStream::Write32

void Write32(wxUint32 i32)

Writes the 32 bit unsigned integer i32 to the stream.

### wxDataOutputStream::Write64

void Write64(wxUint64 i64)

Writes the 64 bit unsigned integer i64 to the stream.

### wxDataOutputStream::WriteDouble

void WriteDouble(double f)

Writes the double f to the stream using the IEEE format.

### wxDataOutputStream::WriteString

void WriteString(const wxString&string)

Writes string to the stream. Actually, this method writes the size of the string before writing string itself.

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 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.