CStrTok:new

The new method creates an instance of the CStrTok class. Note that the object can also be created using new_strtok.

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.

Syntax

S = CStrTok:new( strString, strTokens )

Creates a CStrTok object S and initializes it with the target string and the tokens. You can begin calling Next to parse the target string into tokens.

strString is the string to parse.

strTokens specified the tokens used to parse the string.

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.

On success, a CStrTok object is created and returned.

On failure, nil is returned.

Example

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.

Syntax

Example

Related Topics