Tools.h++ Class Reference

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. The input stream is treated as
a sequence of multibyte characters, each of which is converted to a wide character (using the Standard C
library function mbtowc()) before storing. 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. The input stream is treated as a sequence of multibyte characters, each of which is
converted to a wide character (using the Standard C library function mbtowc()) before storing.
istream&
readToDelim(istream&, wchar_t delim=(wchar_t)'\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.
The input stream is treated as a sequence of multibyte characters, each of which is converted to a wide
character (using the Standard C library function mbtowc()) before storing. Null characters are treated the same
as other characters.
istream&
readToken(istream& s);
Whitespace is skipped before storing characters into wide string. Characters are then read from the input
stream s, replacing previous contents of self, until trailing whitespace or an EOF is encountered. The trailing
whitespace is left on the input stream. Only ASCII whitespace characters are recognized, as defined by the
standard C library function isspace(). The input stream is treated as a sequence of multibyte characters, each
of which is converted to a wide character (using the Standard C library function mbtowc()) before storing.
RWWString&
remove(size_t pos);
Removes the characters from the position pos, which must be no greater than length(), to the end of string.
Returns a reference to self.
RWWString&
remove(size_t pos, size_t N);
Removes N wide characters or to the end of string (whichever comes first) starting at the position pos, which
must be no greater than length(). Returns a reference to self.
RWWString&
replace(size_t pos, size_t N, const wchar_t* cs);
Replaces N wide characters or to the end of string (whichever comes first) starting at position pos, which must
be no greater than length(), with a copy of the null-terminated string cs. Returns a reference to self.
RWWString&
replace(size_t pos, size_t N1,const wchar_t* cs, size_t N2);
Replaces N1 characters or to the end of string (whichever comes first) starting at position pos, which must be
no greater than length(), with a copy of the string cs. Exactly N2 characters are copied, including any
embedded nulls. Hence, the buffer pointed to by cs must be at least N2*sizeof(wchart_t) bytes long. Returns a
reference to self.
RWWString&
replace(size_t pos, size_t N, const RWWString& str);
Replaces N characters or to the end of string (whichever comes first) starting at position pos, which must be
no greater than length(), with a copy of the string str. Returns a reference to self.