Ogni volta che il mIRC trova all'interno di un comando o di un qualsiasi script uno di questo identificatori, lo sostituirà con il rispettivo valore. Alcuni identificatori svolgono prima delle "azioni" e a fine di queste ci restituiscono il valore. Ma il valore restituito può anche risultare $null (nullo), questo $null è molto utile nell'uso di if-then-else. Si possono anche usare più identificatori o variabili contemporaneamente, e tutti saranno valutati.
Gli identificatori si dividono in gruppi in base alle loro caratteristiche come segue:
INDICE
1. Identificatori (ora e data)
2.
Identificatori (file e cartelle)
3.
Identificatori (nick e indirizzo)
4.
Identificatori (testo e numero)
5.
Identificatori (token)
6.
Identificatori (altri)
| $asctime(N,format) |
|
Restituisce il valore di ctime in formato testo data e ora. |
|
$asctime(793947600) |
Restituisce in formato testo il valore del tempo inserito. |
|
$asctime(hh:nn:ss) |
Restituisce l'ora attuale secondo la sintassi ora:minuti:secondi. |
|
$asctime (793947600,dd/mm/yy) |
Restituisce la data del tempo inserito. |
Gli identificatori $time(), $date(), e $gmt() possono essere usati con il formato che segue:
OGGETTO |
FORMATO |
RISULTATO |
|
|
|
Anno |
yy |
02 |
|
yyyy |
2002 |
Mese |
m |
1 |
|
mm |
01 |
|
mmm |
Jan |
|
mmmm |
January |
Giorno |
d |
1 |
|
dd |
01 |
|
ddd |
Mon |
|
dddd |
Monday |
Ora |
h |
5 |
|
hh |
05 |
|
H |
13 |
|
HH |
13 |
Minuto |
n |
1 |
|
nn |
01 |
Secondo |
s |
1 |
|
ss |
01 |
AM/PM |
t |
a/p |
|
tt |
am/pm |
|
T |
A/P |
|
TT |
AM/PM |
Ordinali |
oo |
Primo,secondo, terzo (st/nd/rd/th) |
Fuso Orario |
z |
+0 |
|
zz |
+0000 |
|
zzz |
+0000 GMT |
| $ctime |
|
Restituisce il numero di secondi trascorsi dalle 00:00:00 GMT, 1 gennaio 1970, basandosi sull'ora del sistema. |
|
|
|
| $ctime(text) |
|
Restituisce il numero di secondi trascorsi dalle 00:00:00 GMT, 1 gennaio 1970, basandosi sulla data inserita. |
|
$ctime(January 1 1970 00:00:00) |
|
$ctime(3rd August 1987 3:46pm) |
|
$ctime(21/4/72 1:30:37) |
|
$ctime(Wed 1998-3-27 21:16) |
|
|
|
| $ctimer |
|
Restituisce il nome del timer che ha avviato il rispettivo script. |
|
|
|
| $date |
|
Restituisce la data nel formato europeo. |
|
|
|
| $adate |
|
Restituisce la data nel formato USA. |
|
|
|
| $day |
|
Restituisce il nome del giorno corrente. |
|
|
|
| $duration(secondi,N) |
|
Restituisce il numero dei secondi della settimama/giorno/ ora/minuto/secondo. Il parametro N è opzionale. Se N = 2, il risultato non include il secondo valore. |
|
|
|
| $fulldate |
|
Restituisce la data nel formato: Wed Jun 26 21:41:02 2002 |
|
|
|
| $gmt |
|
Restituisce il tempo del valore corrente GMT nel formato $ctime |
|
|
|
| $idle |
|
Restituisce il tempo di idle come quello restituito da ctcp userinfo e finger. |
|
|
|
| $ltimer |
|
Restituisce il numero dell'ultimo timer. |
|
|
|
| $online |
|
Restituisce il numero di secondi trascorsi sul timer di online. |
|
|
|
| $ticks |
|
Restituisce il numero di ticks (colpi di orologio interno) dall'avvio del S/O. |
|
|
|
| $time |
|
Restituisce l'ora attuale nel formato ora:minuto:secondo |
| $uptime(mirc | server | system, N) |
Restituito in millisecondi. N è opzionale:N = 1 Viene restituito come nel formato $duration(),N = 2 Come sopra ma senza secondi,N = 3 Viene restituito in secondi e non in millisecondi |
| $timer(N/name) |
Restituisce l'id del N timer nella lista dei timers. Si può specificare o il numero del timer, o il nome; questo identificatore lavora col comando /timer.Proprietà: com, time, reps, delay, type, secs, mmt. |
|
|
|
|
$timer(0) |
Restituisce il numero dei timer attivi |
|
$timer(1) |
Restituisce l'id del primo timer della lista. |
|
$timer(1).com |
Restituisce il comando del primo timer della lista. |
|
$timer(3).type |
Restituisce lo stato online/offline per il terzo timer della lista. |
|
$timer(3).secs |
Restituisce i secondi rimasti all'avvio del timer. |
|
$timer(3).mmt |
Restituisce $true se il timer è un multimedia timer. |
|
|
|
| $timestamp |
|
Restituisce l'ora corrente nel formato [xx:xx] |
|
|
|
| $timezone |
|
Restituisce in secondi il fuso orario. |
2. File e Cartelle
$alias(N/nomefile)
Restituisce il nome del file alias caricato. Se il file non esiste restituisce $null.
$alias(0)
Restituisce il numero di file aliases caricati.
$alias(2)
Restituisce il nome del secondo file alias caricato.
$alias(tuttoirc.txt)
Restituisce $null se il file non è caricato, o tuttoirc.txt se lo è.
$crc(nomefile)
Restituisce il CRC contenuto/i nel file specificato.
$disk(C)
Restituisce informazioni sull'hard disk specificato.
Proprietà: type, free, label, size, unc.
$disk(c:)
Restituisce $true se il drive c: esiste, viceversa $false.
La proprietà unc restituisce il percorso per un network drive.
$exists(file/cartella)
Restituisce $true se il file o la cartella esiste, altrimenti $false.
$exists(c:\mirc\mirc.exe) restituisce $true o $false.
$file(nomefile)
Restituisce informazioni sul file specificato.
Proprietà: size, ctime, mtime, atime
$file(mirc.exe).size
Restituisce la dimensione del file.
$file(mirc.exe).ctime
Restituisce l'ora e la data della creazione del file.
$file(mirc.exe).mtime
Restituisce l'ora e la data dell'ultima modifica del file.
$file(mirc.exe).atime
Restituisce l'ora e la data dell'ultimo accesso al file.
$filtered
Restituisce il numero di linee filtrate dal comando /filter.
$finddir(cartella,wildcard,N,depth,@window | comandi)
Cerca nella cartella specificata e nelle sue sotto cartelle i parametri inseriti, restituendo se trovato il percorso e la cartella.
Proprietà: shortfn
$finddir(c:\,mirc*,1)
Restituisce il nome della prima cartella che inizia con mirc.
Se viene specificata una custom @window (con listbox) al posto del parametro N, il risultato
verrà riportato nella listbox della
custom @window.
Se viene specificato un camando, questo sarà eseguito su ogni cartella trovata, per riferirsi al
nome della cartella si usa $1-
//echo 1 $finddir($mircdir,*.*,0,echo $1-).
Se viene specificata la profondità (depth), verranno cercate solo
le cartelle con quella caratteristica e col nome del file inserito.
Nota. Profondità, @window e comandi sono opzionali.
$findfile(cartella,wildcard,N,depth,@window | comandi)
Come il precedente, con la sola differenza che viene cercato un file; vediamo qualche
esempio:
$findfile(c:\mirc,*.exe,1)
Restituisce: c:\mirc\mirc.exe.
//echo 1 $findfile($mircdir,*.*,0,echo $1-)
Restituisce la lista di tutti i file contenuti nella cartella del mIRC e nelle sue sotto cartelle.
$getdir
Restituisce la cartella delle DCC get specificata nell'apposito dialog (DCC Options).
$getdir(filespec)
Restituisce la cartella DCC get in cui si trova il file specificato.
$getdir(*.txt) restituisce per esempio c:\mirc\text\
$ini(file,topic/N,item/N)
Restituisce la posizione del nome/N del topic/item specificato nel file ini/text.
$ini(mirc.ini,0)
Restituisce il numero totale di topics in mirc.ini
$ini(mirc.ini,1)
Restituisce il nome del primo topic in mirc.ini
$ini(mirc.ini,help)
Restituisce la posizione del topic help se esiste, o 0 se non esiste.
Il parametro item/N è opzionale. Se si specifica N = 0, restituisce il numero totale di
topics/items.
$isdir(nomecartella)
Restituisce $true se la cartella esiste, $false se non esiste.
$isfile(nomefile)
Restituisce $true se il file esiste, $false se non esiste.
$lines(nomefile)
Restituisce il numero totale di linee presenti nel file di testo specificato.
$lines(c:\irc\kicks.txt)
Restituisce il numero totale di linee presenti in c:\irc\kicks.txt
$logdir
Restituisce la cartella logs se specificata nella sezione logging del dialog Options.
$longfn(nomefile)
Restituisce per intero il nome di un file abbreviato.
$mididir
Restituisce la cartella midi specificata nella sezione Sound Requests del dialog Options.
$mircdir
Restituisce la cartella del mIRC in uso.
$mircexe
Restituisce il percorso ed il nome del file .exe del mIRC.
$mircini
Restituisce il nome del file principale .ini, di solito mirc.ini.
$nofile(nomefile)
Estrae il nome del file e restituisce il percorso.
$nopath(nomefile)
Restituisce solo il nome del file senza percorso.
$nopath(c:\mirc\mirc.exe) restituisce mirc.exe
$read(nomefile, [ntsw], [matchtext], [N])
Restituisce una linea casuale del file specificato.
//echo $read(funny.txt)
Legge una linea casuale del file funny.txt.
//echo $read(funny.txt, 24)
Legge la linea 24 del file funny.txt.
//kick # $1 $read(kicks.txt)
Legge una linea casuale dal file kicks.txt mettendola come motivazione al kick.
//echo $read(info.txt, s, mirc)
Scansiona il file info.txt alla ricerca di una linea che cominci con la parola mirc.
//echo $read(help.txt, w, *help*)
Scansiona il file help.txt alla ricerca di una linea che contenga la parola help.
//echo $read(versions.txt, w, *mirc*, 100)
Specificando il valore di N la lettura del file inizierà dalla riga N.
Il parametro -n impedisce la valutazione della riga letta. Ciò fa si che tutte le linee siano trattate come semplice testo. Con -t invece anche i numeri saranno trattati come testo.
$readini(nomefile, [n], sezione, item)
Restituisce una singola linea di testo del file .ini.
//echo $readini(mirc.ini, mIRC, nick)
Legge il vostro nickname dal file mirc.ini.
Il parametro -n impedisce la valutazione della linea letta che
viene interpretata come semplice testo.
$sdir(cartella,titolo)
Mostra un dialog con tutte le cartelle, quella selezionata sarà il valore restituito. Il titolo è
opzionale.
$sfile(tipofile,titolo,testodelbottoneOK)
Mostra un dialog nel quale il file scelto sarà il valore restituito.
//run $file(.ini,prova,PROVA OK).
3. Nick e indirizzo
$address(nickname,type)
Cerca nella IAL (Internal Address List) l'indirizzo associato con il nickname specificato
$address(nick,1) ritorna *!*user@host
Se all'interno della IAL non esiste il nick specificato, l'identificatore restituisce come valore
$null
Guardare l'identificatore $mask() per la lista dei type
$anick
Restituisce come valore il nick alternativo (per cambiarlo usare il comando /anick)
$comchan(nick,N)
Ritorna il N canale avente in comune con nick
$comchan(nick,0)
ritorna il numero di canali totali aventi in comune con nick
$comchan(nick,1)
ritorna il primo canale avente in comune con nick
Proprietà: op,help,voice
$comchan(nick,2).op
ritorna $true se il nick sul 2° canale in comune è op, altrimenti $false
$comchan(nick,1).voice
ritorna $true se il nick sul 1° canale è voice, altrimenti $false
$comchan(nick,3).help
ritorna $true se il nick sul 3° canale è helper, altrimenti $false
$ial(nick/mask,N)
Ritorna l'ennesimo nick/mask trovato nella IAL
Esempio:
$ial(*!*@tuttoirc.it,0)
restituisce il numero di utenti aventi l'host tuttoirc.it nella IAL
$ial(*!*@tuttoirc.it,2)
restituisce il 2 utente avente l'host tuttoirc.it nella IAL
$ialchan(nick/mask,#,N)
Ritorna l'ennesima nick/mask trovato nella IAL del canale indicato
$ialchan(*!*@tuttoirc.it,#tuttoirc,0)
restituisce il numero di utenti aventi l'host tuttoirc.it nella IAL del canale #tuttoirc
$ialchan(*!*@tuttoirc.it,#tuttoirc,2)
restituisce il 2° utente avente l'host tuttoirc nella IAL del canale #tuttoirc (se esiste,si tratta di clone:P)
Proprietà: pnick
$ialchan(*!*@tuttoirc.it,#tuttoirc,1).pnick
restituisce il 1° nick con l'host tuttoirc.it nella IAL di #tuttoirc, ma vicino al nick troverete anche il mode (@,+,%,ecc....)
$ibl(#channel,N)
Ritorna l'ennesimo ban presente nella IBL (Internal Ban List), per N uguale a 0 restituisce come valore il numero di ban totali sul canale #channel
(Questo identificatore funziona solo se la IBL è aggiornata)
$ibl(#tuttoirc,2) restituisce il 2° ban presente nella IBL di #tuttoirc
Proprietà: by, date, ctime
$ibl(#tuttoirc,1).by
restituisce il nick da cui è stato settato il 1° ban per la IBL di #tuttoirc
$ibl(#tuttoirc,3).date
restituisce la data del 3° ban che si trova all'interno della IBL di #tuttoirc
$ibl(#tuttoirc,2).ctime
restituisce l'ora in cui è stato settato il 2° ban presente nella IBL di #tuttoirc
(il tempo è dato in formato ctime, per avere il tempo reale, usare $ctime(time) )
$level(address)
Cerca l'indirizzo presente nella user list di mIRC, e restituisce come valore tutte le liste in cui è presente address
$link(N)
Restituisce informazioni sul link numero N, se N è uguale a 0 restituisce come valore il totale dei link
Questo identificatore funziona solo se i links sono mostrati nella finestra dei links (Links Window)
$link(0) restituisce il numero di link totali nella finestra dei links
$link(2) restituisce il secondo link nella finestra dei links
Proprietà: addr, ip, level, info
$link(5).addr restituisce l'indirizzo del 5° link nella finestra dei links
$link(4).ip restituisce l'ip del 4 link nella finestra dei links
$link(8).level restituisce il livello dell'ottavo link nella finestra dei links
$link(2).info restituisce il livello del 2° link nella finsetra dei links
$mask(address,type)
Restituisce come valore la N tipo di maschera specificata in address
$address(smn!boo@tuttoirc.it,1) restituisce come valore *!*boo@tuttoirc.it
$address(smn!boo@tuttoirc.it,2) restituisce come valore *!*@tuttoirc.it
I type di mask sono i seguenti (per address = nick!user@host)
0 --> *!user@host
1 --> *!*user@host
2 --> *!*@host
3 --> *!*user@*.host
4 --> *!*@*.host
5 --> nick!user@host
6 --> nick!*user@host
7 --> nick!*@host
8 --> nick!*user@*.host
9 --> nick!*@*.host
Se invece viene usato per type, un numero da 10 a 19,i * verranno sostituiti con un ?,
$me Restituisce il proprio nick in uso
$mnick Restituisce il tuo main nickname
$nick(#,N/nick,aohvr,aohvr)
Restituisce l'ennesimo nick presente nella listbox di #, se N è uguale a 0, restituisce il numero totali di nick presenti nella nicklist
$nick(#tuttoirc,0)
Restituisce il numero di nick totali presenti nella nicklist del canale #tuttoirc
$nick(#tuttoirc,3)
Restituisce il 3 nick della nicklist del canale #tuttoirc
Proprietà: color, pnick, idle
$nick(#tuttoirc,2).color
Restituisce il colore del 2° nick presente nella nicklist del canale #tuttoirc
$nick(#tuttoirc,3).pnick
Restituisce il 3° nick presente nella nicklist del canale #tuttoirc nel formato @,+,%
$nick(#tuttoirc,1).idle
Restituisce l'idle del 1° nick presente nella nicklist del canale #tuttoirc.
Questa proprietà in realtà, non restituisce come valore il vero idle dell'utente, ma il tempo trascorso dall'ultimo messaggio da lui mandato (sia msg, sia un action,ecc..)
Per quanto riguarda i parametri aohvr (opzionali, si nel 1° che nel 2° caso). Essi vanno a specificare, nel 1° parametro,
i nick che si volgiono mostrare, il 2° parametro i nick che si vogliono escludere.
a = tutti i nick,o = op nick,h = halfops, v = voiced, r = regular
ovviamente per N = 0,verranno inclusi tutti i nick,N = qualsiasi numero, verrà specificato il N nick della nicklist di #channel con la proprietà specificata
$nick(#tuttoirc,0,o,v)
Restituisce come valore il numero totale degli op (o) ed elimina sempre il numero totale dei voice (v)
$nick(#tuttoirc,4,v,o)
Restituisce come valore il 4° nick voice (v) della nick list del canale #tuttoirc, escludendo gli op (o)
Anche in questo caso possono essere usate le proprietà: color, pnick, idle
Per informazioni sulla proprietà pnick, guardare l'identificatore $prefix (//echo -a $prefix)
$notify(N/nick)
Restituisce come valore l'ennesimo nickname presente nella nicklist, se N è uguale a 0, restituisce il numero totale di utenti nella nicklist
$notify(0) Restituisce il numero totale di nick presenti nella nicklist
$notify(2) Restituisce il 2° nick presente nella notify list
Prorietà: ison, note, sound, whois, addr
$notify(3).ison
Restituisce $true se il 3° nick presente nella notify list è su IRC, $false se non si trova su IRC
$notify(1).note
Restituisce le note per il 1° nick presente nella notify list, se le note nn sono aggiunte, restituisce $null
$notify(2).sound
Restituisce la directory del suono da avviare quando il 2° nick presente nella notify list si collega su IRC
$notify(1).whois
Restituisce $true se al collegarsi del 1° nick presente della notify list bisogna avviare un whois sull'utente, $false se nn bisogna avviare il whois
$notify(4).addr
Restituisce l'indirizzo del 4° nick presente nella notify list, se l'indirizzo non viene trovato, restituisce $null
$snicks
Restituisce come valore tutti i nickname selezionati nella nicklist del canale della finestra attiva
nella seguente forma
nick1,nick2,nick3,....,nickN
$snick(#,N)
Restituisce l'ennesimo nick selezionato nel canale specificato, se N è uguale a 0 restituisce il numero totale dei nick selezionati nel canale specificato
e se N non è specificato, restituisce come valore tutti i nick selezionati nel canale specificato, nella seguente forma
nick1,nick2,nick3,....,nickN
$snick(#tuttoirc,0)
Restituisce il numero di tutti i nick selezionati nella nicklist del canale #tuttoirc
$snick(#tuttoirc,4)
Restituisce il 4° nick selezionato nella nicklist del canale #tuttoirc
$snick(#tuttoirc)
Restituisce tutti i nick nella forma nick1,nick2,nick3,....,nickN del canale #tuttoirc
4. Testo e numero
$abs(N)
Restituisce il valore assoluto di N
$abs(8) Restituisce come valore 8
$abs(-3) Restituisce come valore 3
$and(A,B)
Restituisce il valore binario di A and B
$asc(C)
Restituisce il numero ascii del carattere C
$asc(A) Restituisce come valroe 65
$asc(.) Restituisce come valore 46
$asc(,) Non restituisce valori, ma li numero ascii della , è 44
$base(N,inbase,outbase,zeropad,precision)
Restituisce come valore il numero N convertito dalla base inbase alla base outbase
Gli altri due parametri, sono opzionali
$base(15,10,16) Restituisce come valore il numero 15 in base decimale (10) convertito in esadecimale (16), e cioè F
$base(1.5,10,16) Restituisce come valore il numero 1.5 in base decimale (10) convertito in esadecimale (16), e cioè 1.8
$base(2,10,16,3) Restituisce come valore il numero 2 in base decimale (10), convertito in esadecimale (16), e cioè 2, ma se specificato zeropad (3), il valore sarà 002
$biton(A,N)
Restituisce il valore A, con l'ennesimo bit settato su on
$bitoff(A,N)
Restituisce il valore A, con l'ennesimo bit settato su off
$bytes(N,bkmgt3)
Restituisce il valore di N in bytes seguendo il parametro specificato
b = bytes, k = kilobytes, m = megabytes, g = gigabytes
L'opzione 3 restituisce il valore in 3 cifre.
Proprietà: suf
Con questa proprietà al valore sarà aggiunto il suffisso
$bytes(1024768) Restituisce come valore 0.98
$bytes(1024768).suf Restituisce come valore 0.98MB
$bytes(10247680000,3).suf Restituisce come valore 9,54G
$calc(operations)
Restituisce come valore tutte le operations specificate. Possono essere specificate anche piu operazioni
ricordando che saranno eseguite prima le moltiplicazioni e divisione, poi addizioni e sottrazioni
(possono essere usate anche parentesi all'interno di operations, l'importante è chiuderne quante se ne aprono)
$calc(5 + 8) Restituisce come valore 13
$calc((5 + 8) * 2) Restituisce come valore 26
$calc(5 + 8 * 2) Restituisce come valore 21
$calc(5^2) Restituisce come valore 25
Operazioni:
+ = addizione, - = sottrazione, * = moltiplicazione, / = divisione, ^N = elevazione alla N
$chr(N)
Restituisce il carattere ascii specificato in N
$chr(65) Restituisce come valore A
$chr(46) Restituisce come valore .
$chr(44) Restituisce come valore ,
$cos(N),$acos(N)
Restituisce come valore il coseno $cos(N), e l'arcoseno $acor(N), di N
Proprietà: .deg
$count(string,substring,substring2,....,substringN)
Restituisce il numero di substring cercate nella string
$count(hello,el) Restituisce il valore 1
$count(hello,l) Restituisce il valore 2
$encode(%var | &binvar,mubt,N)
$decode(%var | &binvar,mubt,N)
Restituisce come valore la codifica o la decodifica del testo contenuto nella %var o nella &binvar usando la codificazione Uuencode o Mime
Il secondo parametro (mubt) consiste nello specificare il tipo di testo e il tipo di codifica
m = mime, u = uucode (codificazione di default), b = &binvar, t = text (testo di default)
$int(N)
Restituisce il numero interno di n
$int(3.14) Restituisce come valore 3
$isbit(A,N)
Restituisce 1 se l'ennesimo bit è attivo
$islower(text)
Restituisce $true se il testo contenuto in text è tutto scritto in minuscolo
$isupper(text)
Restituisce $true se il testo contenuto in text è tutto scritto in maiuscolo
$left(text,N)
Restituisce fino all'ennesimo carattere partendo da sinistra del testo text
$left(goodbye,4) Restituisce come valore good
Se N è un numero negativo,restituisce tutto il testo tranne gli N caratteri partendo da destra
$len(text)
Restituisce come valore il numero di caratteri presenti in text
$len(#tuttoirc) Restituisce come valore 9
$log(N)
Restituisce il logaritmo naturale di N
$longip(address)
Converte l'ip address (solo ip numerico) in un ip lungo,e viceversa
$longip(158.152.50.239) Restituisce come valore 2660774639
$longip(2660774639) Restituisce come valore 158.152.50.239
$lower(text)
Restituisce il testo text tutto scritto in minuscolo
$lower(CIAO) Restituisce come valore ciao
$mid(text,S,N)
Restituisce come valore gli N caratteri del testo text a partire da S
$mid(othello,3,4) Restituisce come valore hell
Se N è uguale a 0, restituisce come valore il numero totale di caratteri di text partendo dal carattere S
Possono essere usati anche numeri negativi per S ed N
$not(A)
Restituisce il valore binario di not A
$or(A,B)
Restituisce il valore binario di A or B
$ord(N)
Aggiunge al numero N la sua posizione, st, nd, rd
$ord(1) Restituisce come valore 1st
$pos(text,string,N)
Restituisce l'ennesima posizione della stringa string nel testo text
$pos(hello there,e,1) Restituisce come valore 2
$pos(hello there,e,2) Restituisce come valore 9
$pos(hello there,a,1) Restituisce come valore $null
Se N è uguale a 0, restituisce come valore il numero totale di string cercate in text
Possiamo usare $poscs() per usare il case-sensitive, cioè per riconoscere le maiuscole dalle minuscole
$rand(v1,v2)
Questo identificatora lavora in 2 modi diversi. Con le lettere e con i numeri. Se a v1 e v2 specifichiamo due lettere, esso restituirà
come valore una lettere a caso partendo da v1 fino ad arrivare a v2
$rand(a,z) Restituisce come valore una lettera a caso tra a e z
$rand(A,Z) Restituisce come valore una lettera a caso tra A e Z
$rand(n1,n2) Restituisce come valore un numero a caso tra n1 e n2
$remove(string,substring,substring1,...,substringN)
Rimuove tutto quello specificato in substring. Possono essere specificate anche più substring
$remove(abcdefg,cd) Restituisce come valore abefg
$remove(abcdefg,a,c,e,g) Restituisce come valore bdf
Possiamo usare $removecs() per usare il case-sensitive, cioè per riconoscere le maiuscole dalle minuscole
$replace(string,substring,newstring,substring1,newstring1,...
..,substringN,newstringN)
Rimpiazza nel testo string, al posto di substring, la newstring
Possono essere usate anche più stringhe da rimpiazzare
$replace(abcdefg,a,A,b,B,c,C,d,D) Restituisce come valore ABCDefg
Possiamo usare $replacecs() per usare il case-sensitive, cioè per riconoscere le maisucole dalle minuscole
$right(text,N)
Restituisce fino all'ennesimo carattere di text partendo da destra
$right(othello,5) Restituisce come valore hello
Se N è un numero negativo, restituisce tutto il testo tranne gli N caratteri partendo da sinistra
$round(N,D)
Restituisce il valore arrotondato di N, D è un parametro opzionale che se viene usato, restituisce come valore il numero N fino alla D cifra dopo la virgola
$round(3.14159) Restituisce come valore 3
$round(3.14159,2) Restituisce come valore 3.14
$sin(N),$asin(N)
Restituisce come valore il seno $sin(N), e l'arcseno $asin(N), del valore N
Proprietà: deg
$sqrt(N)
Restituisce come valore la radice quadrata del numero N
$str(text,N)
Restituisce come valore il testo text ripetuto N volte
$str(oh,3) Restituisce come valore ohohoh
$strip(text,burcmo)
Restituisce il testo text eliminando i caratteri bold (grassetto), underline (sottolineato), reverse (reverse), e i colori.
Il parametro b u r c m o sono parametri opzionali, e se nn vengono specificati,il valore restituito sarà soltanto il text,senza control code
b = bold, u = underline, r = reverse, c = color
Il parametro m applica lo strip settato nel MESSAGES DIALOG delle opzioni di mIRC, e la o applica l'opzione ONLY IF nelle opzioni di mIRC
$stripped
Restituisce come valore il numero totale dei control codes eliminati da $strip
Questo identificatore può essere usato soltanto negli eventi in cui si riceve un messaggio
$tan(N),$atan(N)
Restituisce il valore tangente $tan(N), e arctangente $atan(N)
Proprietà: deg
$upper(text)
Restituisce tutto il text in maiuscolo
$upper(hello) Restituisce come valore HELLO
$xor(A,B)
Restituisce il valore di A xor B
5. Token
Premessa: Lavorare con i token è divertente e facilita molte operazioni!
Per token si intente PAROLA
Per sapere il numero di un carattere asci, usare $asc(carattere)
Es. $asc(.) Restituisce il numero 46
P.S. In mIRC esiste un bug, cioè se si prova a fare //echo -a $asc(,), esso dara come risultato
$null, quindi non possiamo sapere qual'è il valore ascii della virgola.In ogni caso comunque, il valore
ascii della virgola è: 44
$addtok(text,token,C)
Aggiunge un token alla fine della parola (text) ma solo se token non è già presente in text
Il parametro C è un parametro numerico, che indica il carattere ascii su cui lavorare. Vale per tutti gli identificatori di token
$addtok(a.b.c,d,46)
Restituisce a.b.c.d
$addtok(a.b.c.d,c,46)
Restituisce a.b.c.d, e non a.b.c.d.c, perchè il carattere c già esiste nel text
$addtokcs si usa allo stesso modo di $addtok, solo che usa il case-sensitive, e cioè riconosce le maiuscole dalle minuscole
$deltok(text,N-N2,C)
Cancella l'ennesimo token dal text
$deltok(a.b.c.d,3,46) Restituisce come valore a.b.d
$deltok(a.b.c.d,2-3,46) Restituisce come valore a.d
$deltok(a.b.c.d,2-,46) Restituisce come valore a
Si può anche specificare un numero negativo da sostituire ad N per partire dall'ultimo token
$findtok(text,token,N,C)
Restituisce la posizione dell'ennesimo token cercato in text
$findtok(a.b.c.d,c,1,46) Restituisce come valore 3
$findtok(a.b.c.d,e,1,46) Restituisce $null
$findtok(a.b.c.d.e.f.c,c,0,46) Restituisce come valore 2
Se al posto di N inseriamo 0, il valore che ci sarà restituito sarà uguale al numero totale di tokens specificati
$findtokcs si usa allo stesso modo di $findtok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole
$gettok(text,N,C)
Restituisce l'ennesimo token in text
Se N è uguale a 0, restituirà come valore il numero totale di token in text per il valore ascii di C
$gettok(a.b.c.d.e,3,46) Restituisce come valore c
$gettok(a.b.c.d.e,9,46) Restituisce come valore $null
Possiamo anche specificare un range di token
$gettok(a.b.c.d.e,2-,46) Restituisce come valore b.c.d.e
$gettok(a.b.c.d.e,2-4,46) Restituisce come valore b.c.d
Si può anche specificare un numero negativo da sostituire ad N partire dall'ultimo token
$instok(text,token,N,C)
Inserisce un token nella posizione N nel testo text anche se già esiste il token in text
$instok(a.b.d,c,3,46) Restituisce il valore a.b.c.d
$instok(a.b.d,c,9,46) Restituisce il valore a.b.c.d
Si può anche specificare un numero negativo da sostituire ad N partire dall'ultimo token
$istok(text,token,C)
Restituisce $true se il token nel testo text esiste, altrimenti restituisce $false
$istok(a.b.c.d,c,46) Restituisce come valore $true
$istok(a.b.c.d,e,46) Restituisce come valore $false
$matchtok(text,string,N,C)
Restituisce i token che contentono la parola specificata in string
Se si specifica 0 come valore di N, restituisce il numero di token totali presenti in text contenenti la parola string seguendo il carattere ascii C
$matchtok(one two three,e,0,32)
Restituisce come valore il totale dei token contenenti la parola string nel testo text seguendo il valore ascii C (32, lo spazio)
$matchtok(one two three,e,1,32)
Restituisce come valore one, perchè è il primo token contenente la parola string nel testo text seguendo il valore ascii C (32)
$matchtok(one two three,e,2,32)
Restituisce come valore three, perchè è il secondo token contenente la parola string nel testo text seguendo il valore ascii C (32)
$matchtokcs si usa allo stesso modo di $matchtok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole
$numtok(text,C)
Restituisce il numero di tokens presenti in text
$numtok(a.b.c.d,46) Restituisce il valore 4
$puttok(text,token,N,C)
Sovrascrive l'ennesima linea di token presente in text con il nuovo token
$puttok(a.b.c.d,e,2,46) Restituisce il valore a.e.c.d
Si può anche specificare un numero negativo da sostituire ad N partire dall'ultimo token
$remtok(text,token,N,C)
Rimuove l'ennesimo token cercato in text
$remtok(a.b.c.d,b,1,46) Restituisce come valore a.c.d
$remtok(a.b.c.d.b.e,2,46) Restituisce come valore a.b.c.d.e
$remtokcs si usa allo stesso modo di $remtok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole
$reptok(text,token,new,N,C)
Rimpiazza l'ennesima linea nel text con un nuovo token
$reptok(a.b.c.d,b,e,1,46)
Restituisce come valore a.e.c.d
$reptok(a.b.c.d,f,e,1,46)
Restituisce come valore a.b.c.d perchè il token f non esiste in text
$reptok(a.b.c.d.b.f,b,e,2,46)
Restituisce come valore a.b.c.d.e.f
$reptokcs si usa allo stesso modo di $reptok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole
$sorttok(text,C,ncr)
Ordina i token nel testo text a seconda della flag specificata (ncr)
Se le flag non sono specificare, l'ordinazione di default è in ordine alfabetico, altimenti usare le flag che servono
n = numeric sort, c = channel nick prefix sort, r = reverse sort
$sorttok(e.d.c.b.a,46)
Restituisce come valore a.b.c.d.e
$sorttok(1.3.5.2.4,46,nr)
Restituisce come valore 1.2.3.4.5 perchè è specificata la flag n (numeric sort) che li ordina in modo decrescente, e r (reverse sort) per invertire l'ordine, e per far apparire l'ordine crescente
$sorttokcs si usa allo stesso modo di $sorttok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole
$wildtok(tokens,wildstring,N,C)
Restituisce l'ennesimo token specificato nella wilstring seguendo il valore ascii di C e trovando il N token in text
Se N è uguale a 0, verrà restituito come valore il numero totale di token presenti in text aventi la wildstring seguendo il carattere ascii numero C
$wildtok(one two three,t*,0,32) Restituisce il valore 2
$wildtok(one two three,t*,2,32) Restituisce il valore three, perchè la wildstring t* si trova nel secondo tokens nella scritta text seguendo il carattere ascii numero 32 (lo spazio)
$wildtok(one two three,t*,1,32) Restituisce il valore two, perchè la wildstring t* si trovan nel primo tokens nella scritta text seguendo il carattere ascii numero 32
$wildtok(one two three,t*,3,32) Restituisce $null, perchè non esiste il 3° tokens nel testo text seguendo il carattere ascii 32 avente la wildstring t* al suo interno
$wildtokcs si usa allo stesso modo di $wildtok, solo che usa il case-sensitive, e cioe riconosce le maiuscole dalle minuscole.
6. Altri Identificatori
$+(n1,...nN)
Unisce tutti i testi n1 n2 fino ad nN.Ha lo stesso uso di $+
$?*!="messaggio"
Fà comparire vari dialog di input e restituisce il loro valore.
$?="Qual'è il messaggio" fà comparire un input dialog con un edit dove inserire il testo,un testo "Qual è il messaggio",e due bottoni OK e CANCEL.Se il messaggio
non è specificato, di default comparira la scritta Enter reply: Il valore restituito sarà il testo dell'edit,oppure se si preme cancel, il valore sarà $false
$?*="Qual è la password" è uguale a quello precedente, solo che nell'edit il testo sarà visualizzato con degli **.Il valore restituito sarà il testo dell'edit,oppure se
si preme cancel, il valore sarà $false
$?!="Continuare?" è anch'esso uguale ai precedenti, solo che non ha l'edit.I valori di ritorno possono essere 2, $true se si preme OK, $false se si preme CANCEL
N.B. Per andare a capo nel testo dell'input, usare $crlf
Esempio
$?="Questo è un esempio di $crlf come si va a capo" .
$ansi2mirc(testo)
Ritorna il testo con i codici ANSI convertiti nei colori di mIRC
$away
Può restituire due valori, $true o $false.$true se siamo in away,$false se non siamo in away.
$awaymsg
Restituisce il messaggio di away da noi settato
$awaytime
Indica da quanto tempo siamo in away
N.B. I 3 identificatori $away $awaymsg $awaytime funzionano solo con il nostro nick!
$cb
Restituisce i primi 256 caratteri del testo copiato
$cb(N)
Restituisce la N riga delimitata da un $crlf nel testo copiato
Proprietà: len
$cb(0) Restituisce i numeri totali di linee copiate
$cb(0).len Restituisce la lunghezza totale di tutte le linee copiate
$cb(1) Restituisce la prima linea copiata
$cb(1).len Restituisce la lunghezza della prima linea
$chantypes
Restituisce il tipo di canali che possono essere creati su quel network.Il valore è quello restituito dal raw 005 alla voce CHANTYPES
Quando mIRC non è connesso, di default $chantypes restituisce come valore #&
$chanmodes
Resituisce il tipo di mode che possono essere settati nei canali di quel network.Il valore è quello restituito dal raw 005 alla voce CHANMODES
Quando mIRC non è connesso, di default $chanmodes restituisce come valore ble,k,l
$cmdbox
Restituisce due valore, $true e $false. $true se il comando o lo script è avviato dall'editbox,$false se non è avviato dall'editbox
$cmdline
Restituisce il comando
$color(name / N)
Restituisce il N colore settato nel dialog dei colori di mIRC.$color(action) restituisce il colore dell'action text settato nel dialog dei colori,se invece è specificato il N
il valore restituito sarà l'RGB dell'N colore
Proprietà: dd
$color(action).dd Restituisce il colore in doppio formato
$cr
Restituisce il carattere del "carriage return",ovvero il $chr(13)
$creq
Restituisce il valore delle opzioni di mIRC riguardanti le DCC Chat ,che si può modificare anche tramite il comando /creq
$crlf
Restittuisce la combinazione tra "carriage return" e "linefeed"
$dccignore
Restituisce $true se l'opzione "ignore types" nelle opzioni di mIRC (DCC Folders) è settato on,altrimenti restituisce $false
$dccignore(N / filename)
Restituisce l'N item settato nei tipi di file da ignorare per le DCC.
Se N è 0,restituisce il numero totale degli item,altrimenti restituisce il N item della lista. Se è specificato invece il file, restituisce $true se il file è trovato nella lista
altrimenti restituisce $false
$dccport
Restituisce la porta che mIRC mette in ascolto per il DCC Server
$dll(name.dll,procname,data)
Restituisce il valore chiamato dalla DLL
$editbox(window,N)
Restituisce il testo dell'editbox della window specificato.
Se N = 1, restituisce il testo del secondo editbox negli editbox dei canali, solo se esso è aperto.
$emailaddr
Restituisce l'indirizzo email settato nelle opzioni di mIRC
$eval(text,N)
Valuta il testo N volte.Se N non è specificato, di default ad N sarà assegnato il valore 1.Se N = 0, il testo non sarà valutato
Questo identificatore può permetterti di valutare identificatori e variabili in una linea di testo
$fullname
Restituisce il realname settato nelle opzioni di mIRC
$highlight
Restituisce $true se l'highlight nelle opzioni di mIRC è settata on, altrimenti restituisce $false
$highlight(N / text)
Restituisce la N linea nella highlight list di mIRC.Se text è specificato, restituisce le proprietà per l'highlight trovata nella linea di testo
Proprietà: text, color, sound, flash, message, nicks
$host
Restituisce il proprio host
$iif(C,T,F)
Restituisce T o F a seconda del valore della condizione espressa in C,se esso è vero o falso
$iif(1 == 2,si,no) Restituisce no
Se F non è specificato, $iif restituisce T come valore se la condizione è vera, $false se la condizione non è vera
$ifmatch
Restituisce il primo parametro trovato in una condizione if-then-else
Nel seguente caso:
if (text isin sometext) { ... }
$ifmatch assume il valore di "text"
$ignore(N / address)
Restituisce il N indirizzo nella ignore list
Proprietà: type, secs
$ignore(0) Restituisce il numero totale degli indirizzo nella ignore list
$ignore(1) Restituisce il primo indirizzo nella ignore list
$ignore(2).type Restituisce le flag del 2 indirizzo nella ignore list
$ignore(2).secs Restituisce il numero di secondi rimanenti per eliminare l'indirizzo N 2 dalla ignore list
Se viene specificato un indirizzo invece del numero, il valore restituito sarà il primo indirizzo trovato nella lista, se non esiste restituirà come valore $false
$inpaste
Restituisce $true se abbiamo premuto Control+V oppure Shift+Insert per scrivere qualcosa.Questo identificatore viene usato nell'evento on INPUT
$input(prompt,N,window,title,text)
Fà comparire un input dialog di diverso tipo.Per il testo, puo essere usato $crlf come per $?*!
N può assumere vari valori
e mostra un editbox
p mostra un editbox con password (testo con ***)
o mostra il bottone ok
y mostra i bottoni yes e no
n mostra i bottoni yes no e cancel
r mostra i bottoni retry e cancel
v restituisce come valore $ok $yes $no $cancel per i bottoni
g allineamento a destra dei bottoni
Di default i valori restituiti saranno uguali a quelli di $?*!.Se esiste un editbox,i bottoni ok e yes restituiranno il testo dell'input dialog
gli input dialog possono essere di vari tipo:
i info
q domanda
w attenzione
h rispettiva icona
s indica che la finestra specificata sarà resa attiva
a attiva il dialog
title è il testo della titlebar
text è il testo dell'input dialog
N, window, title e text sono parametri opzionali
Nota: Questo identificatore non può essere usato negli eventi.L'unico modo per farlo funzionare e di usare un timer alla fine dell'evento
$ip
Restituisce il proprio indirizzo ip
$isalias(name)
Restituisce $true se l'alias specificato esiste in un file aliases o remote caricato nel mIRC
Proprietà: fname, alias
$isalias(join)
Restituisce $true se l'alias join esiste
$isalias(join).fname
Restituisce il filename dove è stato trovato l'alias join
$isalias(join).alias
Mostra il codice dell'alias join (solo la prima riga)
$isid
Restituisce $true se l'alias chiamato viene usato come un identificatore, altrimenti restituisce $false
$lf
Restituisce il carattere "linefeed", che equivale al $chr(10)
$lock(item / # / N)
Restituisce $true se il settaggio specificato è bloccato, $false se non lo è
Proprietà: send, get, chat, fserve, run, dll, channels
$md5(text|&binvar|filename,[N])
Restituisce il testo in formato md5, dove N = 0 per testo normale,1 per &binvar, 2 per un file
Se N non è specificato, viene usato di default N = 0
$modespl
Restituisce il numero max di mode che si possono effettuare con il comando /mode.Il valore è restituito dal raw numero 005 alla voce MODES
$network
Restituisce il network a cui siamo connessi.A volte non restituisce alcun valore
$os
Restituisce la versione del sistema operativo in uso. Il valore può essere 95, 98, NT, ME, 2K, XP, or NET.
$port
Restituisce la porta del server a cui siamo connessi
$prefix
Restituisce tutti i mode che si possono avere su un canale.Il valore è restituito dal raw numero 005 alla voce PREFIX
Quando mIRC non è connesso, il valore di $prefix sarà (ohv)@%+.
$rgb(name)
Restituisce il valore l'RGB specificato in name.Name può assumere come valore face, shadow, hilight, 3dlight, fname, text
$server
Restituisce il server a cui si è connessi
Se non siamo connessi, restituisce $null
$server(N / address)
Restituisce il N server nella lista dei server (file servers.ini)
Proprietà: desc, port, group, pass
$server(0)
Restituisce il numero totale dei server nella server list
$server(2)
Restituisce il 2° server nella lista dei server
$server(2).desc
Restituisce la descrizione del 2° server nella lista
$server(1).port
Restituisce le porte a cui è possibile connettersi del 1° server nella lista
$server(1).group
Restituisce il group (Network) del 1° server nella lista
$server(3).pass
Restituisce la password per accedere al 3° server della lista.Se la password non esiste, il valore restituito sarà $null
$serverip
Restituisce l'ip del server
$show
Restituisce $false se il comando viene lanciato con il . (modalità quiete), altrimenti restituisce $false
$sreq
Restituisce il valore delle opzioni di mIRC riguardanti le DCC Send,che si può modificare anche tramite il comando /sreq
$status
Restituisce lo stato della connessione al server
Restituisce closing durante l'evento on DISCONNECT
$titlebar
Restituisce il testo nella titlebar del mIRC, settata dal comando /titlebar
$url
Restituisce l'url attivo nel Web Browser
$url
Restituisce l'N url nella lista degli url
Proprietà: desc, group
$url(0) Restituisce il numero totale degli url presenti nella lista
$url(1) Restituisce il 1° url presente nella lista
$url(1).desc Restituisce la descrizione del 1° url presente nella lista
$url(1).group Restituisce il gruppo del 1° url presente nella lista
$usermode
Restituisce il proprio usermode settati sul server irc
$version
Restituisce la versione di mIRC che stiamo usando
Autore: TuttoIRC
*Un particolare ringraziamento agli amici di TuttoIRC, per aver offerto la presente guida agli indentificatori.
|