Gli Idenrificatori - Token

$addtok(text,token,C)
Aggiunge un token alla fine del testo, ma solo se questo non è già presente nel testo stesso.


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

Il parametro C non è altro che il valore ascii del carattere di separazione del token.

Nota: $addtokcs() è la versione case-sensitive.

$deltok(text,N-N2,C)
Elimina l'Nsimo token dal testo.

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

E' anche possibile specificare un valore negativo per N.


$findtok(text,token,N,C)
Restituisce la posizione dell'Nsimo token corrispondente nel testo.

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

Specificando il valore zero per N, restituisce il numero totale di token corrispondenti.

Nota: $findtokcs() è la versione case-sensitive.

$gettok(text,N,C)
Restituisce l'Nsimo token nel testo.

$gettok(a.b.c.d.e,3,46) restituisce c

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

E' anche possibile specificare un intervallo di token:

$gettok(a.b.c.d.e,2-,46) restituisce l'intervallo dal secondo token in poi: b.c.d.e
$gettok(a.b.c.d.e,2-4,46) restituisce l'intervallo dal secondo al quarto token: b.c.d

E' anche possibile specificare un valore negativo per N.

$instok(text,token,N,C)
Inserisce un token nell'Nsima posizione del testo, anche se il token è già presente nel testo.


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

E' anche possibile specificare un valore negativo per N.

$istok(text,token,C)
Restituisce $true se il token è presente nel testo, altrimenti restituisce $false.

Nota: $istokcs() è la versione case-sensitive.

$matchtok(tokens,string,N,C)
Restituisce i token che contengono la stringa specificata.

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

$matchtok(one two three, e, 2, 32) restituisce three

Specificando il valore zero per N, l'identificatore restituisce il numero totale di token.

Nota: $matchtokcs() è la versione case-sensitive.

$numtok(text,C)
Restituisce il numero di token nel testo.

$puttok(text,token,N,C)
Sovrascrive l'Nsimo token nel testo con un nuovo token.

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

E' anche possibile specificare un valore negativo per N.


$remtok(text,token,N,C)
Rimuove l'Nsimo token corrispondente nel testo.

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

Nota: $remtokcs() è la versione case-sensitive.

$reptok(text,token,new,N,C)
Sostituisce l'Nsimo token corrispondente nel testo con un nuovo token.

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

$reptok(a.b.a.c,a,e,2,46) restituisce a.b.e.c

Nota: $reptokcs() è la versione case-sensitive.

$sorttok(text,C,ncr)
Ordina i token nel testo.

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

L'impostazione predefinita è l'ordine alfabetico, ma è comunque possibile specificare i parametri: n = numeric sort, c = channel nick prefix sort, r = reverse sort.

Nota: $sorttokcs() è la versione case-sensitive.


$wildtok(tokens,wildstring,N,C)
Restituisce l'Nsimo token che corrisponde alla stringa contenente wildcard.

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

Se si specifica il valore zero per N, l'identificatore restituisce il numero totale di token corrispondenti.

Nota: $wildtokcs() è la versione case-sensitive.