|
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. |
|