Tools.h++ Class Reference

appropriate for the final output sink. The model is one where variables are inserted into the
output stream, either individually or as homogeneous vectors, to be restored in the same order
using RWvistream.
Storage and retrieval of characters requires some explanation. Characters can be thought of as
either representing some alphanumeric or control character, or as the literal number. Generally,
the overloaded insertion (<<) and extraction (>>) operators seek to store and restore characters
preserving their symbolic meaning. That is, storage of a newline should be restored as a
newline, regardless of its representation on the target machine. By contrast, member functions
get() and put() should treat the character as a literal number, whose value is to be preserved. See
also class RWpostream.
Persistence
None
Example
#include <rw/vstream.h>
void storeStuff( RWvostream& str) {
int i = 5;
double d = 22.5;
char string[] = "A string with \t tabs and a newline\n";
str << i; // Store an int
str << d; // Store a double
str << string; // Store a string
if(str.fail()) cerr << "Oh, oh, bad news.\n";
}
Public Destructor
virtual ~RWvostream();
This virtual destructor allows specializing classes to deallocate any resources that they
may have allocated.
Public Operators
virtual RWvostream&
operator<<(const char* s) = 0;
Store the character string starting at s to the output stream. The character string is
expected to be null terminated.
virtual RWvostream&