SourcePro® API Reference Guide

 
List of all members | Public Member Functions | Protected Member Functions
RWDataInputStreamImp Class Referenceabstract

Abstract base class from which all data input stream implementation classes must derive. More...

#include <rw/stream/RWDataInputStreamImp.h>

Inheritance diagram for RWDataInputStreamImp:
RWInputStreamImp RWStreamImp RWBodyBase RWTCountingBody< RWMutexLock > RWTMonitor< RWMutexLock > RWDataFromByteInputStreamImp RWDataFromCharInputStreamImp RWDataFromVirtualInputStreamImp RWFilteredDataInputStreamImp RWNativeDataFromByteInputStreamImp RWIstreamDataFromCharInputStreamImp RWObjectInputStreamImp RWSynchronizedDataInputStreamImp RWCompactObjectInputStreamImp RWEnhancedXmlObjectInputStreamImp RWXmlObjectInputStreamImp RWTParsedTransformObjectInputStreamImp< Transform > RWTTransformObjectInputStreamImp< Transform >

Public Member Functions

virtual ~RWDataInputStreamImp ()
 
virtual void getBool (bool &value)=0
 
virtual RWSize getBools (bool *arrayPt, RWSize count)=0
 
virtual void getChar (char &value)=0
 
virtual void getCharacter (char &value)=0
 
virtual RWSize getChars (char *arrayPt, RWSize count)=0
 
virtual RWSize getDelimitedString (char *string, RWSize maxCount, char delim)=0
 
virtual RWSize getDelimitedUString (RWUChar *ustring, RWSize maxCount, RWUChar delim)=0
 
virtual RWSize getDelimitedWString (wchar_t *wstring, RWSize maxCount, wchar_t delim)=0
 
virtual void getDouble (double &value)=0
 
virtual RWSize getDoubles (double *arrayPt, RWSize count)=0
 
virtual void getFloat (float &value)=0
 
virtual RWSize getFloats (float *arrayPt, RWSize count)=0
 
virtual void getInt (int &value)=0
 
virtual RWSize getInts (int *arrayPt, RWSize count)=0
 
virtual void getLong (long &value)=0
 
virtual void getLongDouble (long double &value)=0
 
virtual RWSize getLongDoubles (long double *arrayPt, RWSize count)=0
 
virtual void getLongLong (long long &value)=0
 
virtual RWSize getLongLongs (long long *arrayPt, RWSize count)=0
 
virtual RWSize getLongs (long *arrayPt, RWSize count)=0
 
virtual void getShort (short &value)=0
 
virtual RWSize getShorts (short *arrayPt, RWSize count)=0
 
virtual void getSignedChar (signed char &value)=0
 
virtual RWSize getSignedChars (signed char *arrayPt, RWSize count)=0
 
virtual void getSizeT (size_t &value)=0
 
virtual RWSize getString (char *string, RWSize count)=0
 
virtual void getUCharacter (RWUChar &value)=0
 
virtual void getUnsignedChar (unsigned char &value)=0
 
virtual RWSize getUnsignedChars (unsigned char *arrayPt, RWSize count)=0
 
virtual void getUnsignedInt (unsigned int &value)=0
 
virtual RWSize getUnsignedInts (unsigned int *arrayPt, RWSize count)=0
 
virtual void getUnsignedLong (unsigned long &value)=0
 
virtual void getUnsignedLongLong (unsigned long long &value)=0
 
virtual RWSize getUnsignedLongLongs (unsigned long long *arrayPt, RWSize count)=0
 
virtual RWSize getUnsignedLongs (unsigned long *arrayPt, RWSize count)=0
 
virtual void getUnsignedShort (unsigned short &value)=0
 
virtual RWSize getUnsignedShorts (unsigned short *arrayPt, RWSize count)=0
 
virtual RWSize getUString (RWUChar *arrayPt, RWSize count)=0
 
virtual void getWchar_t (wchar_t &value)=0
 
virtual RWSize getWchar_ts (wchar_t *arrayPt, RWSize count)=0
 
virtual void getWCharacter (wchar_t &value)=0
 
virtual RWSize getWString (wchar_t *wstring, RWSize count)=0
 
- Public Member Functions inherited from RWInputStreamImp
virtual ~RWInputStreamImp ()
 
virtual RWSize available () const =0
 
virtual bool isEof () const =0
 
virtual RWSize skip (RWSize numUnits)=0
 
- Public Member Functions inherited from RWStreamImp
virtual ~RWStreamImp ()
 
virtual void close ()=0
 
virtual bool isBad () const =0
 
virtual bool isFail () const =0
 
virtual bool isGood () const =0
 

Protected Member Functions

 RWDataInputStreamImp ()
 
- Protected Member Functions inherited from RWInputStreamImp
 RWInputStreamImp ()
 
- Protected Member Functions inherited from RWStreamImp
 RWStreamImp ()
 
- Protected Member Functions inherited from RWBodyBase
 RWBodyBase (void)
 
 RWBodyBase (RWStaticCtor)
 
 RWBodyBase (const RWBodyBase &second)
 
virtual ~RWBodyBase (void)
 
RWBodyBaseoperator= (const RWBodyBase &second)
 
- Protected Member Functions inherited from RWTCountingBody< RWMutexLock >
 RWTCountingBody (unsigned initCount=0)
 
 RWTCountingBody (RWStaticCtor)
 
 RWTCountingBody (const RWTCountingBody< RWMutexLock > &second)
 
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 ()
 
 RWTMonitor (RWStaticCtor)
 
 RWTMonitor (const RWTMonitor< RWMutexLock > &second)
 
 ~RWTMonitor ()
 
void acquire ()
 
bool isAcquired () const
 
RWTMonitor< RWMutexLock > & monitor () const
 
RWMutexLockmutex ()
 
RWTMonitor< RWMutexLock > & operator= (const RWTMonitor< RWMutexLock > &)
 
void release ()
 
bool tryAcquire ()
 

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

Abstract base class for all the data input stream implementation classes. Implements the body idiom from the handle-body pattern.

Constructor & Destructor Documentation

virtual RWDataInputStreamImp::~RWDataInputStreamImp ( )
inlinevirtual

Destructor.

RWDataInputStreamImp::RWDataInputStreamImp ( )
inlineprotected

Constructor. Throws no exceptions.

Member Function Documentation

virtual void RWDataInputStreamImp::getBool ( bool &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getBools ( bool *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getChar ( char &  value)
pure virtual
virtual void RWDataInputStreamImp::getCharacter ( char &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getChars ( char *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getDelimitedString ( char *  string,
RWSize  maxCount,
char  delim 
)
pure 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
stringA pointer to the string receiving the narrow characters extracted from the stream.
maxCountThe maximum number of narrow characters to be read.
delimThe narrow character used as a delimiter.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getDelimitedUString ( RWUChar ustring,
RWSize  maxCount,
RWUChar  delim 
)
pure 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
ustringA pointer to the string receiving the UTF-16 characters extracted from the stream.
maxCountThe maximum number of UTF-16 characters to be read.
delimThe UTF-16 character used as a delimiter.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getDelimitedWString ( wchar_t *  wstring,
RWSize  maxCount,
wchar_t  delim 
)
pure 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
wstringA pointer to the string receiving the wide characters extracted from the stream.
maxCountThe maximum number of wide characters to be read.
delimThe wide character used as a delimiter.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getDouble ( double &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getDoubles ( double *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getFloat ( float &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getFloats ( float *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getInt ( int &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getInts ( int *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getLong ( long &  value)
pure virtual
virtual void RWDataInputStreamImp::getLongDouble ( long double &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getLongDoubles ( long double *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getLongLong ( long long &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getLongLongs ( long long *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getLongs ( long *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getShort ( short &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getShorts ( short *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getSignedChar ( signed char &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getSignedChars ( signed char *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getSizeT ( size_t &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getString ( char *  string,
RWSize  count 
)
pure 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
stringA pointer to the string's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWNativeDataFromByteInputStreamImp, RWObjectInputStreamImp, and RWCompactObjectInputStreamImp.

virtual void RWDataInputStreamImp::getUCharacter ( RWUChar value)
pure virtual
virtual void RWDataInputStreamImp::getUnsignedChar ( unsigned char &  value)
pure virtual

Reads a unsigned char value from the stream.

Parameters
valueThe unsigned char value to be read from the stream.

Implemented in RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWDataFromVirtualInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getUnsignedChars ( unsigned char *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getUnsignedInt ( unsigned int &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getUnsignedInts ( unsigned int *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getUnsignedLong ( unsigned long &  value)
pure virtual

Reads a unsigned long value from the stream.

Parameters
valueThe unsigned long value to be read from the stream.

Implemented in RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWFilteredDataInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getUnsignedLongLong ( unsigned long long &  value)
pure virtual

Reads a unsigned long long value from the stream.

Parameters
valueThe unsigned long long value to be read from the stream.

Implemented in RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getUnsignedLongLongs ( unsigned long long *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getUnsignedLongs ( unsigned long *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getUnsignedShort ( unsigned short &  value)
pure virtual

Reads a unsigned short value from the stream.

Parameters
valueThe unsigned short value to be read from the stream.

Implemented in RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWFilteredDataInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getUnsignedShorts ( unsigned short *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual RWSize RWDataInputStreamImp::getUString ( RWUChar arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the string's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWNativeDataFromByteInputStreamImp, RWObjectInputStreamImp, and RWCompactObjectInputStreamImp.

virtual void RWDataInputStreamImp::getWchar_t ( wchar_t &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getWchar_ts ( wchar_t *  arrayPt,
RWSize  count 
)
pure 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
arrayPtA pointer to the array's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWIstreamDataFromCharInputStreamImp, and RWNativeDataFromByteInputStreamImp.

virtual void RWDataInputStreamImp::getWCharacter ( wchar_t &  value)
pure virtual
virtual RWSize RWDataInputStreamImp::getWString ( wchar_t *  wstring,
RWSize  count 
)
pure 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
wstringA pointer to the string's first element.
countThe number of elements to be read from the stream.

Implemented in RWDataFromVirtualInputStreamImp, RWSynchronizedDataInputStreamImp, RWFilteredDataInputStreamImp, RWXmlObjectInputStreamImp, RWEnhancedXmlObjectInputStreamImp, RWIstreamDataFromCharInputStreamImp, RWNativeDataFromByteInputStreamImp, RWObjectInputStreamImp, and RWCompactObjectInputStreamImp.

Copyright © 2023 Rogue Wave Software, Inc., a Perforce company. All Rights Reserved.