Tools.h++ Manual

104011 Tandem Computers Incorporated 21-153
21
virtual RWvistream& get(unsigned char* v, size_t
N);
Redefined from class RWvistream . Get a vector of unsigned char's and store
then in the array beginning at v . If the restore is stopped prematurely, get
stores whatever it can in v , and sets the failbit.
Note – The vector is treated as a vector of numbers, not characters. If you wish
to restore a character string, use function getString(char*, size_t) .
virtual RWvistream& get(unsigned short* v, size_t
N);
Redefined from class RWvistream . Get a vector of unsigned short's and store
then in the array beginning at v . If the restore is stopped prematurely, get
stores whatever it can in v , and sets the failbit.
virtual RWvistream& get(unsigned int* v, size_t
N);
Redefined from class RWvistream . Get a vector of unsigned int's and store
then in the array beginning at v . If the restore is stopped prematurely, get
stores whatever it can in v , and sets the failbit.
virtual RWvistream& get(unsigned long* v, size_t
N);
Redefined from class RWvistream . Get a vector of unsigned long's and store
then in the array beginning at v . If the restore is stopped prematurely, get
stores whatever it can in v , and sets the failbit.
virtual RWvistream& getString(char* s, size_t N);
Redefined from class RWvistream . Restores a character string from the input
stream and stores it in the array beginning at s . The function stops reading at
the end of the string or after N–1 characters, whichever comes first. If the
latter, then the failbit of the stream will be set. In either case, the string will be
terminated with a null byte. If the input stream has been corrupted, then an
exception of type RWExternalErr will be thrown.
virtual RWvistream& getString(wchar_t* ws, size_t N) ;
Redefined from class RWvistream . Restores a character string from the input
stream and stores it in the array beginning at ws . The function stops reading at
the end of the string or after N-1 characters, whichever comes first. If the