RWIstreamDataFromCharInputStreamImp Class Reference

Reads data in US-ASCII format from a narrow character stream. More...

#include <rw/stream/RWIstreamDataFromCharInputStreamImp.h>

Inheritance diagram for RWIstreamDataFromCharInputStreamImp:

Public Member Functions
virtual	~RWIstreamDataFromCharInputStreamImp ()
virtual RWSize	available () const
virtual void	close ()
virtual void	getBool (bool &value)
virtual RWSize	getBools (bool *arrayPt, RWSize count)
virtual void	getChar (char &value)
virtual void	getCharacter (char &value)
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 void	getDouble (double &value)
virtual RWSize	getDoubles (double *arrayPt, RWSize count)
virtual void	getFloat (float &value)
virtual RWSize	getFloats (float *arrayPt, RWSize count)
virtual void	getInt (int &value)
virtual RWSize	getInts (int *arrayPt, RWSize count)
virtual void	getLong (long &value)
virtual void	getLongDouble (long double &value)
virtual RWSize	getLongDoubles (long double *arrayPt, RWSize count)
virtual void	getLongLong (long long &value)
virtual RWSize	getLongLongs (long long *arrayPt, RWSize count)
virtual RWSize	getLongs (long *arrayPt, RWSize count)
virtual void	getShort (short &value)
virtual RWSize	getShorts (short *arrayPt, RWSize count)
virtual void	getSignedChar (signed char &value)
virtual RWSize	getSignedChars (signed char *arrayPt, RWSize count)
virtual void	getSizeT (size_t &value)
virtual RWSize	getString (char *string, RWSize count)
virtual void	getUCharacter (RWUChar &value)
virtual void	getUnsignedChar (unsigned char &value)
virtual RWSize	getUnsignedChars (unsigned char *arrayPt, RWSize count)
virtual void	getUnsignedInt (unsigned int &value)
virtual RWSize	getUnsignedInts (unsigned int *arrayPt, RWSize count)
virtual void	getUnsignedLong (unsigned long &value)
virtual void	getUnsignedLongLong (unsigned long long &value)
virtual RWSize	getUnsignedLongLongs (unsigned long long *arrayPt, RWSize count)
virtual RWSize	getUnsignedLongs (unsigned long *arrayPt, RWSize count)
virtual void	getUnsignedShort (unsigned short &value)
virtual RWSize	getUnsignedShorts (unsigned short *arrayPt, RWSize count)
virtual RWSize	getUString (RWUChar *arrayPt, RWSize count)
virtual void	getWchar_t (wchar_t &value)
virtual RWSize	getWchar_ts (wchar_t *arrayPt, RWSize count)
virtual void	getWCharacter (wchar_t &value)
virtual RWSize	getWString (wchar_t *wstring, 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 RWDataFromCharInputStreamImp
virtual	~RWDataFromCharInputStreamImp ()
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 RWDataInputStream	make (const RWCharInputStream &source)
static RWDataInputStream	make (const RWCharInputStream &source, std::ios *&formatter)

Protected Member Functions
	RWIstreamDataFromCharInputStreamImp (const RWCharInputStream &sourceStream)
	RWIstreamDataFromCharInputStreamImp (const RWCharInputStream &sourceStream, std::ios *&formatter)
std::istream &	getCheckedIstream ()
const std::istream &	getCheckedIstream () const
std::ios &	getIos ()
std::istream &	getIstream ()
const std::istream &	getIstream () const
Protected Member Functions inherited from RWDataFromCharInputStreamImp
	RWDataFromCharInputStreamImp (const RWCharInputStream &sourceStream)
RWCharInputStream &	getSourceStream ()
const RWCharInputStream &	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
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 RWIstreamDataFromCharInputStreamImp reads data in US-ASCII format from a narrow character stream. The RWOstreamDataToCharOutputStreamImp or iostreams std::ostream class generates the format being read. Implements the body idiom from the handle-body pattern.

Constructor & Destructor Documentation

~RWIstreamDataFromCharInputStreamImp()

virtual RWIstreamDataFromCharInputStreamImp::~RWIstreamDataFromCharInputStreamImp ( )

virtual

Destructor.

RWIstreamDataFromCharInputStreamImp() [1/2]

RWIstreamDataFromCharInputStreamImp::RWIstreamDataFromCharInputStreamImp ( const RWCharInputStream & sourceStream )

protected

Initializes the reference to the narrow character stream that will be used as the source of characters.

Parameters

sourceStream

The narrow character stream that will serve as the source of characters.

RWIstreamDataFromCharInputStreamImp() [2/2]

RWIstreamDataFromCharInputStreamImp::RWIstreamDataFromCharInputStreamImp ( const RWCharInputStream & sourceStream, std::ios *& formatter )

protected

Initializes the reference to the narrow character stream that will be used as the source of characters.

Parameters

sourceStream	The narrow character stream that will serve as the source of characters.
formatter	An object that can be used to modify the format recognized by the stream. This object is initialized by the stream and then returned to the caller.

Member Function Documentation

available()

virtual RWSize RWIstreamDataFromCharInputStreamImp::available ( ) const

virtual

Returns the number of narrow characters that can be read from the embedded iostreams std::istream object without blocking. Throws no exceptions.

Reimplemented from RWDataFromCharInputStreamImp.

close()

virtual void RWIstreamDataFromCharInputStreamImp::close ( )

virtual

Forwards the close() call to the next processing narrow character input stream.

Reimplemented from RWDataFromCharInputStreamImp.

getBool()

virtual void RWIstreamDataFromCharInputStreamImp::getBool ( bool & value )

virtual

Reads a bool value from the stream.

Parameters

value

The bool value to be read from the stream.

Implements RWDataInputStreamImp.

getBools()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getBools ( bool * arrayPt, RWSize count )

virtual

Reads an array of bool value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getChar()

virtual void RWIstreamDataFromCharInputStreamImp::getChar ( char & value )

virtual

Reads a char value from the stream.

Parameters

value

The char value to be read from the stream.

Implements RWDataInputStreamImp.

getCharacter()

virtual void RWIstreamDataFromCharInputStreamImp::getCharacter ( char & value )

virtual

Reads a char value from the stream.

Parameters

value

The char value to be read from the stream.

Implements RWDataInputStreamImp.

getChars()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getChars ( char * arrayPt, RWSize count )

virtual

Reads an array of char value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getCheckedIstream() [1/2]

std::istream & RWIstreamDataFromCharInputStreamImp::getCheckedIstream ( )

protected

Returns the embedded iostreams std::istream object that is used to format data.

Exceptions

RWExternalStreamException

Thrown if the embedded std::istream object is in a failed or bad state.

getCheckedIstream() [2/2]

const std::istream & RWIstreamDataFromCharInputStreamImp::getCheckedIstream ( ) const

protected

Returns the embedded iostreams std::istream object that is used to format data.

Exceptions

RWExternalStreamException

Thrown if the embedded std::istream object is in a failed or bad state.

getDelimitedString()

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

virtual

Reads narrow characters from the stream until the last character read is equal to delim, or maxCount narrow characters have been read, or the end of the input sequence is reached. The narrow characters read are stored in string. The function returns the actual number of narrow characters read from the stream.

Parameters

string	A pointer to the string receiving the narrow characters extracted from the stream.
maxCount	The maximum number of narrow characters to be read.
delim	The narrow character used as a delimiter.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getDelimitedUString()

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

virtual

Reads UTF-16 characters from the stream until the last character read is equal to delim, or maxCount UTF-16 characters have been read, or the end of the input sequence is reached. The UTF-16 characters read are stored in ustring. The function returns the actual number of UTF-16 characters read from the stream.

Parameters

ustring	A pointer to the string receiving the UTF-16 characters extracted from the stream.
maxCount	The maximum number of UTF-16 characters to be read.
delim	The UTF-16 character used as a delimiter.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getDelimitedWString()

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

virtual

Reads wide characters from the stream until the last character read is equal to delim, or maxCount wide characters have been read, or the end of the input sequence is reached. The wide characters read are stored in wstring. The function returns the actual number of wide characters read from the stream.

Parameters

wstring	A pointer to the string receiving the wide characters extracted from the stream.
maxCount	The maximum number of wide characters to be read.
delim	The wide character used as a delimiter.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getDouble()

virtual void RWIstreamDataFromCharInputStreamImp::getDouble ( double & value )

virtual

Reads a double value from the stream.

Parameters

value

The double value to be read from the stream.

Implements RWDataInputStreamImp.

getDoubles()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getDoubles ( double * arrayPt, RWSize count )

virtual

Reads an array of double value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getFloat()

virtual void RWIstreamDataFromCharInputStreamImp::getFloat ( float & value )

virtual

Reads a float value from the stream.

Parameters

value

The float value to be read from the stream.

Implements RWDataInputStreamImp.

getFloats()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getFloats ( float * arrayPt, RWSize count )

virtual

Reads an array of float value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getInt()

virtual void RWIstreamDataFromCharInputStreamImp::getInt ( int & value )

virtual

Reads a int value from the stream.

Parameters

value

The int value to be read from the stream.

Implements RWDataInputStreamImp.

getInts()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getInts ( int * arrayPt, RWSize count )

virtual

Reads an array of int value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getIos()

std::ios & RWIstreamDataFromCharInputStreamImp::getIos ( )

inlineprotected

Returns a reference to the std::ios base class of the embedded std::istream object. The std::ios reference can then be used to modify the format flags used by the embedded std::istream object when decoding formatted US-ASCII representation of the data inserted in this input stream.

getIstream() [1/2]

std::istream & RWIstreamDataFromCharInputStreamImp::getIstream ( )

inlineprotected

Returns the embedded iostreams std::istream object that is used to format data. Throws no exceptions.

getIstream() [2/2]

const std::istream & RWIstreamDataFromCharInputStreamImp::getIstream ( ) const

inlineprotected

Returns the embedded iostreams std::istream object that is used to format data. Throws no exceptions.

getLong()

virtual void RWIstreamDataFromCharInputStreamImp::getLong ( long & value )

virtual

Reads a long value from the stream.

Parameters

value

The long value to be read from the stream.

Implements RWDataInputStreamImp.

getLongDouble()

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

virtual

Reads a long double value from the stream.

Parameters

value

The long double value to be read from the stream.

Implements RWDataInputStreamImp.

getLongDoubles()

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

virtual

Reads an array of long double value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getLongLong()

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

virtual

Reads a long long value from the stream.

Parameters

value

The long long value to be read from the stream.

Implements RWDataInputStreamImp.

getLongLongs()

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

virtual

Reads an array of long long value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getLongs()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getLongs ( long * arrayPt, RWSize count )

virtual

Reads an array of long value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getShort()

virtual void RWIstreamDataFromCharInputStreamImp::getShort ( short & value )

virtual

Reads a short value from the stream.

Parameters

value

The short value to be read from the stream.

Implements RWDataInputStreamImp.

getShorts()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getShorts ( short * arrayPt, RWSize count )

virtual

Reads an array of short value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getSignedChar()

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

virtual

Reads a signed char value from the stream.

Parameters

value

The signed char value to be read from the stream.

Implements RWDataInputStreamImp.

getSignedChars()

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

virtual

Reads an array of signed char value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getSizeT()

virtual void RWIstreamDataFromCharInputStreamImp::getSizeT ( size_t & value )

virtual

Reads a size_t value from the stream.

Parameters

value

The size_t value to be read from the stream.

Implements RWDataInputStreamImp.

getString()

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

virtual

Reads a narrow character string from the stream. The string must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

string	A pointer to the string's first element.
count	The number of elements to be read from the stream.

Implements RWDataInputStreamImp.

getUCharacter()

virtual void RWIstreamDataFromCharInputStreamImp::getUCharacter ( RWUChar & value )

virtual

Reads a UTF-16 character from the stream.

Parameters

value

The UTF-16 value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedChar()

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

virtual

Reads a unsigned char value from the stream.

Parameters

value

The unsigned char value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedChars()

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

virtual

Reads an array of unsigned char value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getUnsignedInt()

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

virtual

Reads a unsigned int value from the stream.

Parameters

value

The unsigned int value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedInts()

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

virtual

Reads an array of unsigned int value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getUnsignedLong()

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

virtual

Reads a unsigned long value from the stream.

Parameters

value

The unsigned long value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedLongLong()

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

virtual

Reads a unsigned long long value from the stream.

Parameters

value

The unsigned long long value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedLongLongs()

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

virtual

Reads an array of unsigned long long value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getUnsignedLongs()

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

virtual

Reads an array of unsigned long value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getUnsignedShort()

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

virtual

Reads a unsigned short value from the stream.

Parameters

value

The unsigned short value to be read from the stream.

Implements RWDataInputStreamImp.

getUnsignedShorts()

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

virtual

Reads an array of unsigned short value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getUString()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getUString ( RWUChar * arrayPt, RWSize count )

virtual

Reads a UTF-16 character string from the stream. The string must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the string's first element.
count	The number of elements to be read from the stream.

Implements RWDataInputStreamImp.

getWchar_t()

virtual void RWIstreamDataFromCharInputStreamImp::getWchar_t ( wchar_t & value )

virtual

Reads a wchar_t value from the stream.

Parameters

value

The wchar_t value to be read from the stream.

Implements RWDataInputStreamImp.

getWchar_ts()

virtual RWSize RWIstreamDataFromCharInputStreamImp::getWchar_ts ( wchar_t * arrayPt, RWSize count )

virtual

Reads an array of wchar_t value(s) from the stream. The array must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

arrayPt	A pointer to the array's first element.
count	The number of elements to be read from the stream.

Exceptions

RWIncompleteStreamOperation

Thrown when elements from the stream cannot be read.

Implements RWDataInputStreamImp.

getWCharacter()

virtual void RWIstreamDataFromCharInputStreamImp::getWCharacter ( wchar_t & value )

virtual

Reads a wchar_t value from the stream.

Parameters

value

The wchar_t value to be read from the stream.

Implements RWDataInputStreamImp.

getWString()

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

virtual

Reads a wide character string from the stream. The string must have been pre-allocated to contain at least count elements. The functions return the number of elements read.

Parameters

wstring	A pointer to the string's first element.
count	The number of elements to be read from the stream.

Implements RWDataInputStreamImp.

isBad()

virtual bool RWIstreamDataFromCharInputStreamImp::isBad ( ) const

virtual

Returns true if either one of the embedded iostreams std::istream objects, or the next processing narrow character input stream object is in a bad state. Throws no exceptions.

Reimplemented from RWDataFromCharInputStreamImp.

isEof()

virtual bool RWIstreamDataFromCharInputStreamImp::isEof ( ) const

virtual

Returns true if either one of the embedded iostreams std::istream objects or the next processing narrow character input stream object is in an eof state. Throws no exceptions.

Reimplemented from RWDataFromCharInputStreamImp.

isFail()

virtual bool RWIstreamDataFromCharInputStreamImp::isFail ( ) const

virtual

Returns true if either one of the embedded iostreams std::istream objects or the next processing narrow character input stream object is in a failed state. Throws no exceptions.

Reimplemented from RWDataFromCharInputStreamImp.

isGood()

virtual bool RWIstreamDataFromCharInputStreamImp::isGood ( ) const

virtual

Returns true if both the embedded iostreams std::istream object, and the next processing narrow character input stream object are in good state. Throws no exceptions.

Reimplemented from RWDataFromCharInputStreamImp.

make() [1/2]

static RWDataInputStream RWIstreamDataFromCharInputStreamImp::make ( const RWCharInputStream & source )

inlinestatic

Constructs an RWIstreamDataFromCharInputStreamImp instance that uses source as its source of narrow characters, and returns a handle to it. Throws no exceptions.

Parameters

source

The narrow character stream that is used as the source of characters.

make() [2/2]

static RWDataInputStream RWIstreamDataFromCharInputStreamImp::make ( const RWCharInputStream & source, std::ios *& formatter )

inlinestatic

Constructs an RWIstreamDataFromCharInputStreamImp instance that uses source as its source of narrow characters, and returns a handle to it. Throws no exceptions.

Parameters

source	The narrow character stream that is used as the source of characters.
formatter	An object that can be used to modify the format recognized by the stream. This object is initialized by the stream and then returned to the caller.

skip()

virtual RWSize RWIstreamDataFromCharInputStreamImp::skip ( RWSize numUnits )

virtual

Skips numUnits narrow characters from the embedded iostreams std::istream object if possible. The function returns the actual number of narrow characters skipped, which can be any value between 0 and numUnits.

Parameters

numUnits

The number of narrow characters to be skipped.

Reimplemented from RWDataFromCharInputStreamImp.