Tools.h++ Class Reference

Prepend the first N bytes or the length of cstr (whichever is less) of cstr to self. Returns a
reference to self.
istream&
readFile(istream& s);
Reads characters from the input stream s, replacing the previous contents of self, until
EOF is reached. Null characters are treated the same as other characters.
istream&
readLine(istream& s, RWBoolean skipWhite = TRUE);
Reads characters from the input stream s, replacing the previous contents of self, until a
newline (or an EOF) is encountered. The newline is removed from the input stream but is
not stored. Null characters are treated the same as other characters. If the skipWhite
argument is TRUE, then whitespace is skipped (using the iostream library manipulator ws)
before saving characters.
istream&
readString(istream& s);
Reads characters from the input stream s, replacing the previous contents of self, until an
EOF or null terminator is encountered. If the number of bytes remaining in the stream is
large, you should resize the RWCString to approximately the number of bytes to be read
prior to using this method. See "Implementation Details" in the User's Guide for more
information. This function is incompatible with strings with embedded nulls. This function
may be incompatible with MBCS strings.
istream&
readToDelim(istream& s, char delim='\n');
Reads characters from the input stream s, replacing the previous contents of self, until an
EOF or the delimiting character delim is encountered. The delimiter is removed from the
input stream but is not stored. Null characters are treated the same as other characters. If
delim is '\0' then this function is incompatible with strings with embedded nulls. If delim is
'\0' then this function may be incompatible with MBCS strings.
istream&
readToken(istream& s);
Whitespace is skipped before saving characters. Characters are then read from the input
stream s, replacing previous contents of self, until trailing whitespace or an EOF is
encountered. The whitespace is left on the input stream. Null characters are treated the
same as other characters. Whitespace is identified by the standard C library function
isspace(). This function is incompatible with MBCS strings.
RWCString&
remove(size_t pos);
Removes the bytes from the byte position pos, which must be no greater than length(), to
the end of string. Returns a reference to self.
RWCString&