Tools.h++ Manual
21-212 104011 Tandem Computers Incorporated
21
RWWString& prepend(const wchar_t* cs, size_t N,);
Prepend a copy of the character string
cs
to self. Exactly
N
characters are
copied, including any embedded nulls. Hence, the buffer pointed to by
cs
must
be at least
N
bytes long. Returns a reference to self.
RWWString& prepend(const RWWString& str);
Prepends a copy of the string
str
to self. Returns a reference to self.
RWWString& prepend(const RWWString& cstr, size_t
N);
Prepend the first
N
characters 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. 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& 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. 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