Reads and restores objects encoded in XML from the supplied RWDataInputStream. More...

#include <rw/xmlstreams/RWXmlObjectInputStreamImp.h>

Inheritance diagram for RWXmlObjectInputStreamImp:

Public Member Functions
virtual void	endAssoc ()

virtual void	endBlock ()

virtual void	endElement ()

virtual void	endMap ()

virtual void	endMember ()

virtual void	endSequence ()

virtual void	getBool (bool &value)

virtual void	getChar (char &value)

virtual void	getCharacter (char &value)

virtual void	getDouble (double &value)

virtual void	getFloat (float &value)

virtual void	getInt (int &value)

virtual void	getLong (long &value)

virtual void	getLongDouble (long double &value)

virtual void	getLongLong (long long &value)

virtual void *	getNewObject (const std::type_info *base)

virtual void	getShort (short &value)

virtual void	getSignedChar (signed char &value)

virtual void	getSizeT (size_t &value)

virtual void	getString (RWCString &str)

void	getSymbol (RWSymbol &value)

virtual void	getUCharacter (RWUChar &value)

virtual void	getUnsignedChar (unsigned char &value)

virtual void	getUnsignedInt (unsigned int &value)

virtual void	getUnsignedLong (unsigned long &value)

virtual void	getUnsignedLongLong (unsigned long long &value)

virtual void	getUnsignedShort (unsigned short &value)

virtual void	getUString (RWBasicUString &str)

virtual void	getWchar_t (wchar_t &value)

virtual void	getWCharacter (wchar_t &value)

virtual void	getWString (RWWString &str)

virtual RWSymbol	readTypeInfo ()

virtual void	rememberObject (const void *obj)

virtual void	startAssocKey ()

virtual void	startAssocValue ()

virtual RWSymbol	startBlock ()

virtual void	startElement (int &position)

virtual RWSymbol	startMap (int &count, RWStreamType &keyType, RWStreamType &valueType)

virtual bool	startMember (RWSymbol &memberName, RWStreamType &memberType)

virtual RWSymbol	startSequence (int &count, RWStreamType &elementType)

Public Member Functions inherited from RWObjectInputStreamImp
virtual void	closeContext (bool readContext=true)

virtual void	endParent ()

virtual void	openContext (bool readContext=true)

virtual void	peekChar (char &value)

virtual void	peekCharacter (char &value)

virtual void	startParent (const RWSymbol &)

Public Member Functions inherited from RWFilteredDataInputStreamImp
virtual	~RWFilteredDataInputStreamImp ()

virtual RWSize	available () const

virtual void	close ()

virtual RWSize	getBools (bool *arrayPt, RWSize count)

virtual RWSize	getChars (char *arrayPt, RWSize count)

virtual RWSize	getDelimitedString (char *string, RWSize maxCount, char delim)

virtual RWSize	getDelimitedUString (RWUChar *ustring, RWSize maxCount, RWUChar delim)

virtual RWSize	getDelimitedWString (wchar_t *wstring, RWSize maxCount, wchar_t delim)

virtual RWSize	getDoubles (double *arrayPt, RWSize count)

virtual RWSize	getFloats (float *arrayPt, RWSize count)

virtual RWSize	getInts (int *arrayPt, RWSize count)

virtual RWSize	getLongDoubles (long double *arrayPt, RWSize count)

virtual RWSize	getLongLongs (long long *arrayPt, RWSize count)

virtual RWSize	getLongs (long *arrayPt, RWSize count)

virtual RWSize	getShorts (short *arrayPt, RWSize count)

virtual RWSize	getSignedChars (signed char *arrayPt, RWSize count)

virtual RWSize	getUnsignedChars (unsigned char *arrayPt, RWSize count)

virtual RWSize	getUnsignedInts (unsigned int *arrayPt, RWSize count)

virtual RWSize	getUnsignedLongLongs (unsigned long long *arrayPt, RWSize count)

virtual RWSize	getUnsignedLongs (unsigned long *arrayPt, RWSize count)

virtual RWSize	getUnsignedShorts (unsigned short *arrayPt, RWSize count)

virtual RWSize	getWchar_ts (wchar_t *arrayPt, RWSize count)

virtual bool	isBad () const

virtual bool	isEof () const

virtual bool	isFail () const

virtual bool	isGood () const

virtual RWSize	skip (RWSize numUnits)

Public Member Functions inherited from RWDataInputStreamImp
virtual	~RWDataInputStreamImp ()

Public Member Functions inherited from RWInputStreamImp
virtual	~RWInputStreamImp ()

Public Member Functions inherited from RWStreamImp
virtual	~RWStreamImp ()

Static Public Member Functions
static RWObjectInputStream	make (RWDataInputStream &source, bool escape=true)

static RWObjectInputStream	make (std::istream &source, bool escape=true)

static RWObjectInputStream	make (std::istream &source, std::ios *&formatter, bool escape=true)

Static Public Member Functions inherited from RWXmlObjectStreamCommon
static const char *	rwStreamToLocalStringType (RWStreamType stype)

static const char *	rwStreamToStringType (RWStreamType stype)

Protected Member Functions
	RWXmlObjectInputStreamImp (const RWDataInputStream &sourceStream, bool escape)

	RWXmlObjectInputStreamImp (std::istream &sourceStream, bool escape)

	RWXmlObjectInputStreamImp (std::istream &sourceStream, std::ios *&formatter, bool escape)

virtual void	closeOuterContext (bool readContext)

virtual RWSize	getString (char *string, RWSize count)

virtual RWSize	getUString (RWUChar *ustring, RWSize count)

virtual RWSize	getWString (wchar_t *wstring, RWSize count)

virtual void	openOuterContext (bool readContext)

Protected Member Functions inherited from RWObjectInputStreamImp
	RWObjectInputStreamImp (const RWDataInputStream &sourceStream)

Protected Member Functions inherited from RWFilteredDataInputStreamImp
	RWFilteredDataInputStreamImp (const RWDataInputStream &sourceStream)

RWDataInputStream &	getSourceStream ()

const RWDataInputStream &	getSourceStream () const

Protected Member Functions inherited from RWDataInputStreamImp
	RWDataInputStreamImp ()

Protected Member Functions inherited from RWInputStreamImp
	RWInputStreamImp ()

Protected Member Functions inherited from RWStreamImp
	RWStreamImp ()

Protected Member Functions inherited from RWBodyBase
	RWBodyBase (const RWBodyBase &second)

	RWBodyBase (RWStaticCtor)

	RWBodyBase (void)

virtual	~RWBodyBase (void)

RWBodyBase &	operator= (const RWBodyBase &second)

Protected Member Functions inherited from RWTCountingBody< RWMutexLock >
	RWTCountingBody (const RWTCountingBody< RWMutexLock > &second)

	RWTCountingBody (RWStaticCtor)

	RWTCountingBody (unsigned initCount=0)

RWTCountingBody< RWMutexLock > &	operator= (const RWTCountingBody< RWMutexLock > &second)

	~RWTCountingBody (void)

unsigned	addReference (void)

unsigned	references (void) const

unsigned	removeReference (void)

Protected Member Functions inherited from RWTMonitor< RWMutexLock >
	RWTMonitor (const RWTMonitor< RWMutexLock > &second)

	RWTMonitor (RWStaticCtor)

	RWTMonitor (void)

	~RWTMonitor (void)

void	acquire (void)

bool	isAcquired (void) const

RWTMonitor< RWMutexLock > &	monitor (void) const

RWMutexLock &	mutex (void)

RWTMonitor< RWMutexLock > &	operator= (const RWTMonitor< RWMutexLock > &)

void	release (void)

bool	tryAcquire (void)

Additional Inherited Members
Static Public Attributes inherited from RWXmlObjectStreamCommon
static const char *	associationTag

static const char *	assocKeyTag

static const char *	assocValueTag

static const char *	elementPosAttr

static const char *	IdAttr

static const char *	IdRefAttr

static const char *	mapCountAttr

static const char *	mapKeyTypeAttr

static const char *	mapTag

static const char *	mapValueTypeAttr

static const char *	memberNameAttr

static const char *	memberTag

static const char *	memberTypeAttr

static const char *	nestedObjectTag

static const char *	objectNameAttr

static const char *	objectRefTag

static const char *	objectRefTagLocal

static const char *	objectTag

static const char *	objectTypeAttr

static const char *	primitiveTag

static const char *	rwEncodingNamespaceValue

static const char *	rwNamespace

static const char *	rwNamespaceAttr

static const char *	rwNamespaceValue

static const char *	seqCountAttr

static const char *	seqTypeAttr

static const char *	sequenceElementTag

static const char *	sequenceTag

static const char *	xsdNamespace

static const char *	xsdNamespaceAttr

static const char *	xsdNamespaceValue

static const char *	xsiNamespace

static const char *	xsiNamespaceAttr

static const char *	xsiNamespaceValue

Protected Types inherited from RWTCountingBody< RWMutexLock >
typedef RWTLockGuard< RWTMonitor< RWMutexLock > >	LockGuard

typedef RWTTryLockGuard< RWTMonitor< RWMutexLock > >	TryLockGuard

typedef RWTUnlockGuard< RWTMonitor< RWMutexLock > >	UnlockGuard

Protected Types inherited from RWTMonitor< RWMutexLock >
typedef RWTLockGuard< RWTMonitor< RWMutexLock > >	LockGuard

typedef RWTTryLockGuard< RWTMonitor< RWMutexLock > >	TryLockGuard

typedef RWTUnlockGuard< RWTMonitor< RWMutexLock > >	UnlockGuard

Detailed Description

The class RWXmlObjectInputStreamImp reads and restores objects encoded in XML from the supplied RWDataInputStream. Typically, the XML stream was originally created by the class RWXmlObjectOutputStreamImp, thereby ensuring symmetry of the output and subsequent input.

The XML Streams Module integrates with the general Rogue Wave streams architecture defined by the streams and serialization packages of the Advanced Tools Module of SourcePro Core. This architecture allows an XML stream to be written out and read in using a wide variety of streaming configurations. For more information specific to the XML Streams Module, see the XML Streams Module User's Guide. For information on the general architecture, see the Advanced Tools Module User's Guide.

RWXmlObjectInputStreamImp is the body class of a handle-body pattern. The corresponding handle class is RWObjectInputStream.

The syntax of the XML formatting parsed by this class is defined by the XML schema xmlstreams.xsd. This schema is located in buildspace\rw\xmlstreams.

Example: // Open an fstream to serve as our source.

ifstream s("foo.xml");

// Create an XML data stream using the fstream.

RWObjectInputStream in = RWXmlObjectInputStreamImp::make(s);

// Read an integer from the XML data stream.

int i;

s >> i;

RWObjectInputStream
Handle class for object input stream implementation classes.
Definition RWObjectInputStream.h:59

RWXmlObjectInputStreamImp::make
static RWObjectInputStream make(std::istream &source, bool escape=true)

Constructor & Destructor Documentation

◆ RWXmlObjectInputStreamImp() [1/3]

RWXmlObjectInputStreamImp::RWXmlObjectInputStreamImp	(	std::istream &	sourceStream,
		bool	escape )

inlineprotected

Used by the make() function and potentially by derived classes to initialize the source data stream if the required input stream is a standard library istream.

The parameter sourceStream is a handle to the initialized stream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

◆ RWXmlObjectInputStreamImp() [2/3]

RWXmlObjectInputStreamImp::RWXmlObjectInputStreamImp	(	std::istream &	sourceStream,
		std::ios *&	formatter,
		bool	escape )

inlineprotected

Used by the make() function and potentially by derived classes to initialize the source data stream if the required input stream is a standard library istream.

The parameter sourceStream is a handle to the initialized stream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

This constructor also takes a pointer reference to an std::ios formatting object.

Before the XML stream is created, pass an empty formatting object pointer to this constructor through the make() function. This constructor, in defining the underlying character stream for the XML stream, creates a formatting object for the stream and places the address of that object in the pointer reference. The calling application can then use this formatting object to manipulate data formats in the XML stream. See the corresponding make() function description for an example.

◆ RWXmlObjectInputStreamImp() [3/3]

RWXmlObjectInputStreamImp::RWXmlObjectInputStreamImp	(	const RWDataInputStream &	sourceStream,
		bool	escape )

inlineprotected

Used by the make() function and potentially by derived classes to initialize the source data stream if the required input stream is a RWDataInputStream istream.

The parameter sourceStream is a handle to the initialized stream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

Member Function Documentation

◆ closeOuterContext()

virtual void RWXmlObjectInputStreamImp::closeOuterContext ( bool readContext )

protectedvirtual

Really closes an open context, called when closeContext() calls match the number of openContext() calls.

Implements RWObjectInputStreamImp.

◆ endAssoc()

virtual void RWXmlObjectInputStreamImp::endAssoc ( )

virtual

Called by the input operators for association types after each value.

Reimplemented from RWObjectInputStreamImp.

◆ endBlock()

virtual void RWXmlObjectInputStreamImp::endBlock ( )

virtual

Inputs tokens that identify the end of an object.

Implements RWObjectInputStreamImp.

◆ endElement()

virtual void RWXmlObjectInputStreamImp::endElement ( )

virtual

Called by the input operators for collection types after each element in a sequence.

Reimplemented from RWObjectInputStreamImp.

◆ endMap()

virtual void RWXmlObjectInputStreamImp::endMap ( )

virtual

Called by the input operators for association types after all the pairs.

Reimplemented from RWObjectInputStreamImp.

◆ endMember()

virtual void RWXmlObjectInputStreamImp::endMember ( )

virtual

Called by streamContents() after each data member is read.

Reimplemented from RWObjectInputStreamImp.

◆ endSequence()

virtual void RWXmlObjectInputStreamImp::endSequence ( )

virtual

Called by the input operators for collection types at the end of a sequence.

Reimplemented from RWObjectInputStreamImp.

◆ getBool()

virtual void RWXmlObjectInputStreamImp::getBool ( bool & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getChar()

virtual void RWXmlObjectInputStreamImp::getChar ( char & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWObjectInputStreamImp.

◆ getCharacter()

virtual void RWXmlObjectInputStreamImp::getCharacter ( char & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWObjectInputStreamImp.

◆ getDouble()

virtual void RWXmlObjectInputStreamImp::getDouble ( double & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getFloat()

virtual void RWXmlObjectInputStreamImp::getFloat ( float & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getInt()

virtual void RWXmlObjectInputStreamImp::getInt ( int & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getLong()

virtual void RWXmlObjectInputStreamImp::getLong ( long & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getLongDouble()

virtual void RWXmlObjectInputStreamImp::getLongDouble ( long double & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getLongLong()

virtual void RWXmlObjectInputStreamImp::getLongLong ( long long & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getNewObject()

virtual void * RWXmlObjectInputStreamImp::getNewObject ( const std::type_info * base )

virtual

Reads the dynamic type information (derived class) from the input stream, and factories an instance of this type.

Parameters

base	Represents the static type (base class) of the field being read.

Implements RWObjectInputStreamImp.

◆ getShort()

virtual void RWXmlObjectInputStreamImp::getShort ( short & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getSignedChar()

virtual void RWXmlObjectInputStreamImp::getSignedChar ( signed char & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getSizeT()

virtual void RWXmlObjectInputStreamImp::getSizeT ( size_t & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getString() [1/2]

virtual RWSize RWXmlObjectInputStreamImp::getString	(	char *	string,
		RWSize	count )

inlineprotectedvirtual

Forward the reading of a string of narrow characters from the attached source stream. The function returns the number of narrow characters read.

Parameters

string	A pointer to the first element of the string. The string must have been pre-allocated to contain at least count narrow characters.
count	The number of narrow character(s) to be read from the stream.

Reimplemented from RWObjectInputStreamImp.

◆ getString() [2/2]

virtual void RWXmlObjectInputStreamImp::getString ( RWCString & str )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Implements RWObjectInputStreamImp.

◆ getSymbol()

void RWXmlObjectInputStreamImp::getSymbol ( RWSymbol & value )

virtual

Reads an RWSymbol value from the stream.

Parameters

value The RWSymbol value to be read from the stream.

Reimplemented from RWObjectInputStreamImp.

◆ getUCharacter()

virtual void RWXmlObjectInputStreamImp::getUCharacter ( RWUChar & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUnsignedChar()

virtual void RWXmlObjectInputStreamImp::getUnsignedChar ( unsigned char & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUnsignedInt()

virtual void RWXmlObjectInputStreamImp::getUnsignedInt ( unsigned int & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUnsignedLong()

virtual void RWXmlObjectInputStreamImp::getUnsignedLong ( unsigned long & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUnsignedLongLong()

virtual void RWXmlObjectInputStreamImp::getUnsignedLongLong ( unsigned long long & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUnsignedShort()

virtual void RWXmlObjectInputStreamImp::getUnsignedShort ( unsigned short & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getUString() [1/2]

virtual void RWXmlObjectInputStreamImp::getUString ( RWBasicUString & str )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Implements RWObjectInputStreamImp.

◆ getUString() [2/2]

virtual RWSize RWXmlObjectInputStreamImp::getUString	(	RWUChar *	ustring,
		RWSize	count )

inlineprotectedvirtual

Forward the reading of a string of UTF-16 characters from the attached source stream. The function returns the number of UTF-16 characters read.

Parameters

ustring	A pointer to the first element of the string. The string must have been pre-allocated to contain at least count unicode characters.
count	The number of unicode character(s) to be read from the stream.

Reimplemented from RWObjectInputStreamImp.

◆ getWchar_t()

virtual void RWXmlObjectInputStreamImp::getWchar_t ( wchar_t & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getWCharacter()

virtual void RWXmlObjectInputStreamImp::getWCharacter ( wchar_t & value )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Reimplemented from RWFilteredDataInputStreamImp.

◆ getWString() [1/2]

virtual void RWXmlObjectInputStreamImp::getWString ( RWWString & str )

virtual

Reads a value from the stream, where the type of the value is defined by the first parameter.

Implements RWObjectInputStreamImp.

◆ getWString() [2/2]

virtual RWSize RWXmlObjectInputStreamImp::getWString	(	wchar_t *	wstring,
		RWSize	count )

inlineprotectedvirtual

Forward the reading of a string of wide characters from the attached source stream. The function returns the number of wide characters read.

Parameters

wstring	A pointer to the first element of the string. The string must have been pre-allocated to contain at least count wide characters.
count	The number of wide character(s) to be read from the stream.

Reimplemented from RWObjectInputStreamImp.

◆ make() [1/3]

static RWObjectInputStream RWXmlObjectInputStreamImp::make	(	RWDataInputStream &	source,
		bool	escape = true )

static

Constructs an RWXmlObjectInputStreamImp instance that uses the data stream source as its source of bytes, and returns a handle to it. Use this method when the data input stream is a RWDataInputStream istream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML. By default, this parameter is set to true.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

◆ make() [2/3]

static RWObjectInputStream RWXmlObjectInputStreamImp::make	(	std::istream &	source,
		bool	escape = true )

static

Constructs an RWXmlObjectInputStreamImp instance that uses the data stream source as its source of bytes, and returns a handle to it. Use this method when the data input stream is a standard library istream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML. By default, this parameter is set to true.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

◆ make() [3/3]

static RWObjectInputStream RWXmlObjectInputStreamImp::make	(	std::istream &	source,
		std::ios *&	formatter,
		bool	escape = true )

static

Constructs an RWXmlObjectInputStreamImp instance that uses the data stream source as its source of bytes, and returns a handle to it. Use this method when the data input stream is a standard library istream.

The parameter escape sets whether the input stream contains escapes for XML reserved characters that need to be unescaped. Usually this would be because the objects serialized out with RWXmlObjectOutputStreamImp contained embedded XML. By default, this parameter is set to true.

The reserved characters are:

< > & " '

You get slightly better performance if the escape parameter is set to false, but before doing so be certain that your data does not contain reserved characters.

This function also takes a pointer reference to an std::ios formatting object. An empty formatting object pointer is created before the XML stream is created and is passed through this make() function to the constructor:

std::ios* formatter;  // uninitialized pointer
RWObjectInputStream xistr =
    RWXmlObjectInputStreamImp::make(infile, formatter);

The constructor, in creating the underlying character stream for the XML stream, creates a formatting object for the stream and places the address of that object in the pointer reference. The calling application can then use this formatting object to manipulate data formats in the XML stream.

formatter->precision(15); // manipulate data format

◆ openOuterContext()

virtual void RWXmlObjectInputStreamImp::openOuterContext ( bool readContext )

protectedvirtual

Really opens a new context, called by openContext() when a context is not already open.

Implements RWObjectInputStreamImp.

◆ readTypeInfo()

virtual RWSymbol RWXmlObjectInputStreamImp::readTypeInfo ( )

virtual

Reads the type information for an class instance from the stream and returns it as a symbol.

Implements RWObjectInputStreamImp.

◆ rememberObject()

virtual void RWXmlObjectInputStreamImp::rememberObject ( const void * obj )

virtual

Called by streaming operators to record each instance streamed in, in case it is referenced again in the same context.

Implements RWObjectInputStreamImp.

◆ startAssocKey()

virtual void RWXmlObjectInputStreamImp::startAssocKey ( )

virtual

Called by the input operators for association types before each key.

Reimplemented from RWObjectInputStreamImp.

◆ startAssocValue()

virtual void RWXmlObjectInputStreamImp::startAssocValue ( )

virtual

Called by the input operators for association types after each key and before each value.

Reimplemented from RWObjectInputStreamImp.

◆ startBlock()

virtual RWSymbol RWXmlObjectInputStreamImp::startBlock ( )

virtual

Inputs tokens that identify the start of a new object. Returns an RWSymbol representing the new object. Depending on the implementation class associated with this handle, the RWSymbol may be empty.

Implements RWObjectInputStreamImp.

◆ startElement()

virtual void RWXmlObjectInputStreamImp::startElement ( int & )

virtual

Called by the input operators for collection types before each element in a sequence.

Reimplemented from RWObjectInputStreamImp.

◆ startMap()

virtual RWSymbol RWXmlObjectInputStreamImp::startMap	(	int &	count,
		RWStreamType &	keyType,
		RWStreamType &	valueType )

virtual

Called by the input operators for association types (hash tables, etc.) at the start of a sequence. Returns an RWSymbol representing the collection.

Parameters

count	Contains the number of items in the association.
keyType	Contains the type of key in the association.
valueType	Contains the type of value in the association.

Implements RWObjectInputStreamImp.

◆ startMember()

virtual bool RWXmlObjectInputStreamImp::startMember	(	RWSymbol &	memberName,
		RWStreamType &	memberType )

virtual

Called for before each data member by the streamContents() function, metadata about the field may or may not be read from the stream depending on the implementation. If data is read (returning true), then parameter memberName will contain the name of the member. Otherwise returns false.

Implements RWObjectInputStreamImp.

◆ startSequence()

virtual RWSymbol RWXmlObjectInputStreamImp::startSequence	(	int &	count,
		RWStreamType &	elementType )

virtual

Called by the input operators for collection types at the start of a sequence. Returns an RWSymbol representing the collection.

Parameters

count	Contains the number of items in the collection.
elementType	Contains the type of element in the collection.

Implements RWObjectInputStreamImp.

SourcePro® API Reference Guide

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ RWXmlObjectInputStreamImp() [1/3]

◆ RWXmlObjectInputStreamImp() [2/3]

◆ RWXmlObjectInputStreamImp() [3/3]

Member Function Documentation

◆ closeOuterContext()

◆ endAssoc()

◆ endBlock()

◆ endElement()

◆ endMap()

◆ endMember()

◆ endSequence()

◆ getBool()

◆ getChar()

◆ getCharacter()

◆ getDouble()

◆ getFloat()

◆ getInt()

◆ getLong()

◆ getLongDouble()

◆ getLongLong()

◆ getNewObject()

◆ getShort()

◆ getSignedChar()

◆ getSizeT()

◆ getString() [1/2]

◆ getString() [2/2]

◆ getSymbol()

◆ getUCharacter()

◆ getUnsignedChar()

◆ getUnsignedInt()

◆ getUnsignedLong()

◆ getUnsignedLongLong()

◆ getUnsignedShort()

◆ getUString() [1/2]

◆ getUString() [2/2]

◆ getWchar_t()

◆ getWCharacter()

◆ getWString() [1/2]

◆ getWString() [2/2]

◆ make() [1/3]

◆ make() [2/3]

◆ make() [3/3]

◆ openOuterContext()

◆ readTypeInfo()

◆ rememberObject()

◆ startAssocKey()

◆ startAssocValue()

◆ startBlock()

◆ startElement()

◆ startMap()

◆ startMember()

◆ startSequence()