Token Identifiers

$addtok(text,token,C)
Adds a token to the end of text but only if it's not already in text.

$addtok(a.b.c,d,46)	returns a.b.c.d
$addtok(a.b.c.d,c,46)	returns a.b.c.d

The C parameter is the ascii value of the character separating the tokens.

Note: $addtokcs() is the case-sensitive version.

$deltok(text,N-N2,C)
Deletes the Nth token from text.

$deltok(a.b.c.d,3,46)	returns a.b.d
$deltok(a.b.c.d,2-3,46)	returns a.d

You can specify a negative value for N.

$findtok(text,token,N,C)
Returns the position of the Nth matching token in text.

$findtok(a.b.c.d,c,1,46)	returns 3
$findtok(a.b.c.d,e,1,46)	returns $null

If you specify zero for N, it returns the total number of matching tokens.

Note: $findtokcs() is the case-sensitive version.

$gettok(text,N,C)
Returns the Nth token in text.

$gettok(a.b.c.d.e,3,46)	returns c
$gettok(a.b.c.d.e,9,46)	returns $null

You can also specify a range of tokens:

$gettok(a.b.c.d.e,2-,46)	returns 2nd token onwards b.c.d.e
$gettok(a.b.c.d.e,2-4,46)	returns tokens 2 through 4 b.c.d

You can specify a negative value for N.

$instok(text,token,N,C)
Inserts token into the Nth position in text, even if it already exists in text.

$instok(a.b.d,c,3,46)	returns a.b.c.d
$instok(a.b.d,c,9,46)	returns a.b.d.c

You can specify a negative value for N.

$istok(text,token,C)

Returns $true if token exists, otherwise returns $false.

Note: $istokcs() is the case-sensitive version.

$matchtok(tokens,string,N,C)
Returns tokens that contain the specified string.

$matchtok(one two three, e, 0, 32) returns 2
$matchtok(one two three, e, 2, 32) returns three

If you specify zero for N, it returns the total number of matching tokens.

Note: $matchtokcs() is the case-sensitive version.

$numtok(text,C)

Returns number of tokens in text.

$puttok(text,token,N,C)
Overwrites the Nth token in text with a new token.

$puttok(a.b.c.d,e,2,46)	returns a.e.c.d

You can specify a negative value for N.

$remtok(text,token,N,C)
Removes the Nth matching token from text.

$remtok(a.b.c.d,b,1,46)	returns a.c.d
$remtok(a.b.c.d,e,1,46)	returns a.b.c.d
$remtok(a.c.c.d,c,1,46)	returns a.c.d

Note: $remtokcs() is the case-sensitive version.

$reptok(text,token,new,N,C)

Replaces the Nth matching token in text with a new token.

$reptok(a.b.c.d,b,e,1,46)	returns a.e.c.d
$reptok(a.b.c.d,f,e,1,46)	returns a.b.c.d
$reptok(a.b.a.c,a,e,2,46)	returns a.b.e.c

Note: $reptokcs() is the case-sensitive version.

$sorttok(text,C,ncra)
Sorts the tokens in text.

$sorttok(e.d.c.b.a,46)	returns a.b.c.d.e
$sorttok(1.3.5.2.4,46,nr)	returns 5.4.3.2.1

The default is an alphabetic sort, however you can specify n = numeric sort, c = channel nick prefix sort, r = reverse sort, a = alphanumeric sort.

Note: $sorttokcs() is the case-sensitive version.

$wildtok(tokens,wildstring,N,C)
Returns the Nth token that matches the wildcard string.

$wildtok(one two three, t*, 0, 32) returns 2
$wildtok(one two three, t*e, 1, 32) returns three

If you specify zero for N, it returns the total number of matching tokens.

Note: $wildtokcs() is the case-sensitive version.