Tools.h++ Manual

104011 Tandem Computers Incorporated 21-209
21
start plus len must be less than or equal to the string length. If the library
was built using the RWDEBUG flag, and start and len are out of range, then
an exception of type RWBoundsErr will be thrown.
Public member functions RWWString& append(const wchar_t* cs);
Append a copy of the null-terminated character string pointed to by cs to self.
Returns a reference to self.
RWWString& append(const wchar_t* cs, size_t N) ;
Append 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& append(const RWWString& cstr) ;
Append a copy of the string cstr to self. Returns a reference to self.
RWWString& append(const RWWString& cstr, size_t
N);
Append the first N characters or the length of cstr (whichever is less) of cstr
to self. Returns a reference to self.
size_t binaryStoreSize() const ;
Returns the number of bytes necessary to store the object using the global
function
RWFile& operator<<(RWFile&, const RWWString&) ;
size_t capacity() const;
Return the current capacity of self. This is the number of characters the string
can hold without resizing.
size_t capacity(size_t capac);
Hint to the implementation to change the capacity of self to capac . Returns
the actual capacity.
int collate(const RWWString& str) const;
int collate(const wchar_t* str) const;
Returns an int less then, greater than, or equal to zero, according to the result
of calling the POSIX function ::wscoll() on self and the argument str . This
supports locale-dependent collation.
int compareTo(const RWWString& str,
caseCompare = exact) const;
int compareTo(const wchar_t* str,
caseCompare = exact) const;