Node:String streams, Next:, Previous:File streams, Up:Reference



String streams

The string stream classes provide a means of turning arbitrary strings (or "blocks") in memory into a binary stream, similary to what strstream does in the iostream library.

Unlike strstream from the iostream library, these streams do not support automatic enlarging of the memory area. If the user tries to write beyond the end of the stream, nothing is actually written and an Eof error is issued.

Header file: binstr.h

Public methods:

binsbase(void *str, unsigned long len)

binisstream(void *str, unsigned long len)

binosstream(void *str, unsigned long len)

binsstream(void *str, unsigned long len)
All constructors take two arguments. str is a pointer to a previously initialized data string in memory. len specifies the length in bytes of the string.
~binsbase()

~binisstream()

~binosstream()

~binsstream()
All deconstructors.
virtual void seek(long pos, Offset offs = Set)
virtual long pos()
Implementation of the abstract virtual methods, inherited from binio. Refer to the reference of that class for more information.

Protected data types and variables in binsbase:

Byte *data
This pointer is always pointing to the beginning of the initialized data string in memory, passed to the constructor.
Byte *spos
This pointer points to the current position in the string stream.
long length
Holds the length in bytes for the whole data string in memory, as passed to the constructor.