Panda3D
Public Member Functions
StreamReader Class Reference

A class to read sequential binary data directly from an istream. More...

#include "streamReader.h"

List of all members.

Public Member Functions

 StreamReader (istream &in)
 StreamReader (istream *in, bool owns_stream)
 If owns_stream is true, the stream pointer will be deleted when the StreamReader destructs.
 StreamReader (const StreamReader &copy)
 The copy constructor does not copy ownership of the stream.
string extract_bytes (size_t size)
 Extracts the indicated number of bytes in the stream and returns them as a string.
float get_be_float32 ()
 Extracts a 32-bit single-precision big-endian floating-point number.
PN_float64 get_be_float64 ()
 Extracts a 64-bit big-endian floating-point number.
PN_int16 get_be_int16 ()
 Extracts a signed big-endian 16-bit integer.
PN_int32 get_be_int32 ()
 Extracts a signed big-endian 32-bit integer.
PN_int64 get_be_int64 ()
 Extracts a signed big-endian 64-bit integer.
PN_uint16 get_be_uint16 ()
 Extracts an unsigned big-endian 16-bit integer.
PN_uint32 get_be_uint32 ()
 Extracts an unsigned big-endian 32-bit integer.
PN_uint64 get_be_uint64 ()
 Extracts an unsigned big-endian 64-bit integer.
bool get_bool ()
 Extracts a boolean value.
string get_fixed_string (size_t size)
 Extracts a fixed-length string.
float get_float32 ()
 Extracts a 32-bit single-precision floating-point number.
PN_float64 get_float64 ()
 Extracts a 64-bit floating-point number.
PN_int16 get_int16 ()
 Extracts a signed 16-bit integer.
PN_int32 get_int32 ()
 Extracts a signed 32-bit integer.
PN_int64 get_int64 ()
 Extracts a signed 64-bit integer.
PN_int8 get_int8 ()
 Extracts a signed 8-bit integer.
istream * get_istream () const
 Returns the stream in use.
string get_string ()
 Extracts a variable-length string.
string get_string32 ()
 Extracts a variable-length string with a 32-bit length field.
PN_uint16 get_uint16 ()
 Extracts an unsigned 16-bit integer.
PN_uint32 get_uint32 ()
 Extracts an unsigned 32-bit integer.
PN_uint64 get_uint64 ()
 Extracts an unsigned 64-bit integer.
PN_uint8 get_uint8 ()
 Extracts an unsigned 8-bit integer.
string get_z_string ()
 Extracts a variable-length string, as a NULL-terminated string.
void operator= (const StreamReader &copy)
 The copy constructor does not copy ownership of the stream.
string readline ()
 Assumes the stream represents a text file, and extracts one line up to and including the trailing newline character.
void skip_bytes (size_t size)
 Skips over the indicated number of bytes in the stream.

Detailed Description

A class to read sequential binary data directly from an istream.

Its interface is similar to DatagramIterator by design; see also StreamWriter.

Definition at line 30 of file streamReader.h.


Constructor & Destructor Documentation

StreamReader::StreamReader ( istream *  in,
bool  owns_stream 
) [inline]

If owns_stream is true, the stream pointer will be deleted when the StreamReader destructs.

Definition at line 35 of file streamReader.I.

StreamReader::StreamReader ( const StreamReader copy) [inline]

The copy constructor does not copy ownership of the stream.

Definition at line 48 of file streamReader.I.


Member Function Documentation

string StreamReader::extract_bytes ( size_t  size)

Extracts the indicated number of bytes in the stream and returns them as a string.

Returns empty string at end-of-file.

Definition at line 122 of file streamReader.cxx.

float StreamReader::get_be_float32 ( ) [inline]

Extracts a 32-bit single-precision big-endian floating-point number.

Since this kind of float is not necessarily portable across different architectures, special care is required.

Definition at line 334 of file streamReader.I.

References ReversedNumericData::store_value().

PN_float64 StreamReader::get_be_float64 ( ) [inline]

Extracts a 64-bit big-endian floating-point number.

Definition at line 353 of file streamReader.I.

References ReversedNumericData::store_value().

PN_int16 StreamReader::get_be_int16 ( ) [inline]

Extracts a signed big-endian 16-bit integer.

Definition at line 247 of file streamReader.I.

References ReversedNumericData::store_value().

PN_int32 StreamReader::get_be_int32 ( ) [inline]

Extracts a signed big-endian 32-bit integer.

Definition at line 261 of file streamReader.I.

References ReversedNumericData::store_value().

PN_int64 StreamReader::get_be_int64 ( ) [inline]

Extracts a signed big-endian 64-bit integer.

Definition at line 275 of file streamReader.I.

References ReversedNumericData::store_value().

PN_uint16 StreamReader::get_be_uint16 ( ) [inline]

Extracts an unsigned big-endian 16-bit integer.

Definition at line 289 of file streamReader.I.

References ReversedNumericData::store_value().

PN_uint32 StreamReader::get_be_uint32 ( ) [inline]

Extracts an unsigned big-endian 32-bit integer.

Definition at line 303 of file streamReader.I.

References ReversedNumericData::store_value().

Referenced by HashVal::input_binary().

PN_uint64 StreamReader::get_be_uint64 ( ) [inline]

Extracts an unsigned big-endian 64-bit integer.

Definition at line 317 of file streamReader.I.

References ReversedNumericData::store_value().

bool StreamReader::get_bool ( ) [inline]

Extracts a boolean value.

Definition at line 97 of file streamReader.I.

References get_uint8().

string StreamReader::get_fixed_string ( size_t  size)

Extracts a fixed-length string.

However, if a zero byte occurs within the string, it marks the end of the string.

Definition at line 85 of file streamReader.cxx.

float StreamReader::get_float32 ( ) [inline]

Extracts a 32-bit single-precision floating-point number.

Since this kind of float is not necessarily portable across different architectures, special care is required.

Definition at line 214 of file streamReader.I.

References NativeNumericData::store_value().

PN_float64 StreamReader::get_float64 ( ) [inline]

Extracts a 64-bit floating-point number.

Definition at line 233 of file streamReader.I.

References NativeNumericData::store_value().

PN_int16 StreamReader::get_int16 ( ) [inline]

Extracts a signed 16-bit integer.

Definition at line 127 of file streamReader.I.

References NativeNumericData::store_value().

PN_int32 StreamReader::get_int32 ( ) [inline]

Extracts a signed 32-bit integer.

Definition at line 141 of file streamReader.I.

References NativeNumericData::store_value().

PN_int64 StreamReader::get_int64 ( ) [inline]

Extracts a signed 64-bit integer.

Definition at line 155 of file streamReader.I.

References NativeNumericData::store_value().

PN_int8 StreamReader::get_int8 ( ) [inline]

Extracts a signed 8-bit integer.

Definition at line 107 of file streamReader.I.

istream * StreamReader::get_istream ( ) const [inline]

Returns the stream in use.

Definition at line 87 of file streamReader.I.

Extracts a variable-length string.

Definition at line 24 of file streamReader.cxx.

References get_uint16().

Extracts a variable-length string with a 32-bit length field.

Definition at line 43 of file streamReader.cxx.

References get_uint32().

PN_uint16 StreamReader::get_uint16 ( ) [inline]

Extracts an unsigned 16-bit integer.

Definition at line 169 of file streamReader.I.

References NativeNumericData::store_value().

Referenced by get_string().

PN_uint32 StreamReader::get_uint32 ( ) [inline]

Extracts an unsigned 32-bit integer.

Definition at line 183 of file streamReader.I.

References NativeNumericData::store_value().

Referenced by DatagramInputFile::get_datagram(), get_string32(), and DatagramInputFile::save_datagram().

PN_uint64 StreamReader::get_uint64 ( ) [inline]

Extracts an unsigned 64-bit integer.

Definition at line 197 of file streamReader.I.

References NativeNumericData::store_value().

PN_uint8 StreamReader::get_uint8 ( ) [inline]

Extracts an unsigned 8-bit integer.

Definition at line 117 of file streamReader.I.

Referenced by get_bool().

Extracts a variable-length string, as a NULL-terminated string.

Definition at line 64 of file streamReader.cxx.

void StreamReader::operator= ( const StreamReader copy) [inline]

The copy constructor does not copy ownership of the stream.

Definition at line 61 of file streamReader.I.

Assumes the stream represents a text file, and extracts one line up to and including the trailing newline character.

Returns empty string when the end of file is reached.

The interface here is intentionally designed to be similar to that for Python's File.readline() function.

Definition at line 147 of file streamReader.cxx.

void StreamReader::skip_bytes ( size_t  size)

Skips over the indicated number of bytes in the stream.

Definition at line 104 of file streamReader.cxx.


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations