CStrTok:Next

The Next method steps through the target string, returning the next token from the target string. If there are no more tokens remaining, nil is returned. As each piece of the target string is parsed, you use it or you might store it in an array for later use (see the Example, below).

Syntax

sStr = CStrTok:Next()

where

sStr is the next string token from the target string.

Example

The following script parses the string sStr into pieces delimited by ", \t" (comma, blank, and tab characters). In this example, the pieces are stored in a table (an array) named A for later use.

T = CStrTok:new( sStr, ", \t" )	-- create a new CStrTok object initialized to the target
	-- string sStr and the delimiters.
A = { }	-- create table A to hold the string tokens
n = 0	-- start index with no tokens counted
while true do	-- loop until there are no more tokens
str = T:Next()	-- get the next token
if str ~= nil then	-- if a token exists
n = n + 1	-- advance to the next table index
A[n] = str	-- add the token string to the table
else
break	-- no more tokens, break out of the loop
end	-- end of test
end	-- end of parsing loop
--	-- work with the string pieces in array A.
T:delete()	-- delete the object and its associated memory.