Tools.h++ Class Reference

Click on the banner to return to the Class Reference home page.
©Copyright 1996 Rogue Wave Software
RWWSubString
Synopsis●
Description●
Persistence●
Example●
Assignment Operators●
Indexing Operators●
Public Member Functions●
Global Logical Operators●
Synopsis
#include <rw/wstring.h>
RWWString s(L"test string");
s(6,3); // "tri"
Description
The class RWWSubString allows some subsection of an RWWString to be addressed by
defining a starting position and an extent. For example the 7th through the 11th elements,
inclusive, would have a starting position of 7 and an extent of 5. The specification of a starting
position and extent can also be done in your behalf by such functions as RWWString::strip() or
the overloaded function call operator taking a regular expression as an argument. There are no
public constructors -- RWWSubStrings are constructed by various functions of the RWWString
class and then destroyed immediately.
A zero lengthsubstring is one with a defined starting position and an extent of zero. It can be
thought of as starting just before the indicated character, but not including it. It can be used as
an lvalue. A null substring is also legal and is frequently used to indicate that a requested
substring, perhaps through a search, does not exist. A null substring can be detected with
member function isNull(). However, it cannot be used as an lvalue.