CStrTok:new
The new method creates an instance of the CStrTok class. This method returns a reference to the object it creates. The calling code must assign this reference to a name (see below). If the object cannot be created, nil is returned.
Note: This method's name uses all lower case to present it as the analog of the C++ new operator. Generally, the names of class methods begin with an uppercase letter but new and delete are different.
S = CStrTok:new( sString, sDelimiters )
Creates a CStrTok object S and initializes it with the target string and the delimiters. You can begin calling Next to parse the target string into tokens.
S = CStrTok:new()
Default constructor. The new CStrTok S is not initialized. You must call Init before parsing the string.
S = CStrTok:new( CStrTok2 )
This is a copy constructor. The new CStrTok S is initialized to the target string and delimiters of the CStrTok instance.
The following example shows the use of a constructor and destructor pair:
T = CStrTok:new( sStr, ", \t" ) |
-- create a new CStrTok object initialized to the |
|
-- string sStr and delimiters comma, blank, and tab |
... |
-- parse the string and save or use its pieces here |
T:delete() |
-- delete the object and its associated memory. |