Portale IRC - Guide scripts e snippet

martedì 16 novembre 2010

Gli Identificatori - File e Cartelle

$abook(nick,N)
Restituisce informazioni riguardanti i nicknames inseriti nella lista dell' address book.

Proprietà: nick, info, email, website, noteN

Formati consentiti: $abook(nick) $abook(N) $abook(nick,N) dove il nick può essere anche un wildcard.

$alias(N/nomefile)
Restituisce il nome del file per l'Nsimo file di alias caricato. Se viene specificato un nome di file, restituisce $null se il file non è caricato.



$alias(0) restituisce il numero di file di alias caricati
$alias(2) restituisce il nome del secondo file di alias caricato
$alias(moo.txt) restituisce $null se il file non è caricato, oppure moo.txt se lo è.

$crc(nomefile)
Restituisce il CRC dei contenuti del file specificato.

$disk(C)
Restituisce informazioni riguardanti l'hard disk specificato.

Proprietà: type, free, label, size, unc


$disk(c:) restituisce $true se il disco c: esiste, altrimenti restituisce $false

La proprietà Unc restituisce il percorso del drive

$exists(nomefile)
Restituisce $true se il file esiste, altrimenti $false

$exists(c:.exe) restituisce $true o $false.

$file(nomefile)
Restituisce informazioni riguardanti il file specificato.

Proprietà: size, ctime, mtime, atime.

$file(nomefile).size restituisce la dimensione del file

$file(nomefile).ctime restituisce l'ora della creazione
$file(nomefile).mtime restituisce l'ora dell'ultima modifica
$file(nomefile).atime restituisce l'ora dell'ultimo accesso

$filtered

Restituisce il numero di righe che sono state filtrate con il comando /filter.

$finddir(dir,wildcard,N,depth,@window | comando)
Cerca all'interno della cartella specificata e delle sue sottocartelle in base all'Nsimo nome di cartella corrispondente alla specifica del wildcard e restituisce il path completo e la cartella se viene trovata.

Proprietà: versione corta del nome di un file

$finddir(c:,mirc*,1) cerca all'interno di c: la prima cartella il cui nome inizia con "mirc"


Se viene specificata una @window (con un listbox) invece del parametro N, mIRC riempirà il listabox della @window con i risultati.

Se viene specificato un comando, questo comando verrà eseguito su ogni cartella che viene trovata. E' possibile usare $1- in riferimento al nome della cartella, p.es:

//echo 1 $finddir($mircdir,*.*,0,echo $1-)

Se viene specificato il parametro depth, mIRC cercherà soltanto all'interno di N cartelle per trovare i parametri richiesti.


Nota: sia il parametro depth, sia @window/comando sono opzionali.

$findfile(dir,wildcard,N,depth,@window | comando)
Cerca all'interno della cartella specificata e delle sue sottocartelle in base all'Nsimo nome di file corrispondente alla specifica del wildcard e restituisce il path completo e il nome del file se viene trovato.

Proprietà: funzione corta del nome di un file lungo


$findfile(c:,*.exe,1) restituisce c:.exe

Se viene specificato il nome di una @window invece dell'Nsimo parametro, mIRC riempirà il listbox della @window con i risultati.

Se viene specificato un comando, questo comando verrà eseguito su ogni file che viene trovato. E' possibile usare $1- in riferimento al nome del file, p.es:

//echo 1 $findfile($mircdir,*.*,0,echo $1-)

Se viene specificato il parametro depth, mIRC cercherà soltanto all'interno di N cartelle per trovare i parametri richiesti.


Nota: sia il parametro depth, sia sia @window/comando sono opzionali.

$getdir
Restituisce il nome della cartella della DCC Get, specificata nella finestra delle opzioni.

$getdir(filespec)
Restituisce il nome della cartella della DCC Get per il tipo di file specificato.

$getdir(*.txt) restituisce, per esempio c:

$ini(file,argomento/N,elemento/N)
Restituisce il nome o l'Nsima posizione di argomento/elemento specificato, all'interno di un file ini.


$ini(mirc.ini,0) restituisce il numero di argomenti all'interno del file mirc.ini
$ini(mirc.ini,1) restituisce il nome del primo argomento all'interno del file mirc.ini
$ini(mirc.ini,help) restituisce l'Nsima posizione dell'argomento "help" se esiste, altrimenti restituisce 0

Il parametro elemento/N è opzionale. Se viene specificato N=0, viene restituito il numero totale di argomenti/elementi

$isdir(nomecartella)
Restituisce $true se la cartella indicata esiste, altrimenti restituisce $false


$isfile(nomefile)
Restituisce $true se il file indicato esiste, altrimenti restituisce $false

$lines(nomefile)
Restituisce il numero totale di linee all'interno del file di testo specificato.

$lines(c:.txt) restituisce il numero di linee all'interno del file c:.txt

$logdir
Restituisce il nome della cartella dedicata ai Logs, come specificato nella sezione "Logging" nella finestra delle opzioni.

$longfn(nomefile)

Restituisce la versione lunga di un nome di file abbreviato. Funziona solo nella versione a 32 bit, mentre in quella a 16 restituisce lo stesso nome di file.

$mididir
Restituisce la cartella Midispecificata nella sezione Sound Request della finestra delle Opzioni

$mircdir
Restituisce l'attuale cartella del programma mIRC

$mircexe
Restituisce il path completo e il nome del file dell'eseguibile del mIRC

$mircini

Restituisce il nome del principale file .ini del mIRC, solitamente mirc.ini

$mklogfn(filename)
Restituisce il formato del nome del file che viene usato per il logging. Inserisce la data nel nome del file, se è stata inserita l'opzione relativa nella finestra delle impostazioni.

E' anche possibile utilizzare $mknickfn(nickname) per fissare un nickname da utilizzare come nome di file, e $mkfn(filename), che semplicemente rimuove i caratteri non validi.


$nofile(nomefile)
Restituisce il path del file indicato, senza il nome del file.

$nopath(nomefile)
Restituisce il nome del file senza path.


$read (nomefile, [ntsw], [matchtext], [N]
Restituisce una linea singola del testo del file.

//echo $read(funny.txt)

$read leggerà in modo casuale le linee dal file Funny.txt

//echo $readfunny.txt, 24)

$read leggerà la linea 24 del file funny.txt

//kick # $1 $read(kicks.txt)

$read leggerà a caso tra le linee di kick nel file kicks.txt e le userà nel comando di kick

//echo $read(info.txt, s, mirc)

$read scruterà il file info.txt alla ricerca della prima linea che inizia con la parola mirc


//echo $read(help.txt, w, *help*)

$read scruterà il file help.txt alla ricerca del carattere *help*

Se viene specificato un comando s o w, si potrà introdurre il valore N per specificare da che linee del file partire con la ricerca, eg.:

//echo $read(version.txt, w, *mirc*, 100)

Se il parametro -n è specificato, allora la linea letta non sarà valutata e verrà trattata come testo semplice.

Se la prima linea del file è un numero, è necessario rappresentare il numero totale di linee nel file. Se viene specificato N=0, mirc restituirà il valore della prima linea se questa è un numero.


Se il parametro -t è specificato, mIRC tratterà la prima linea come testo semplice, anche se si tratta di un numero.

$readn
Resituisce il numero di linee che saranno abbinate alla prossima chiamata del comando read(). Se nn viene travato alcun abbinamento $readn sarà impostato come 0

$readini(nomefile, [n], sezione, punto)
Restituisce la singola linea dal testo del file con estensione .ini

/echo $readini(mirc.ini mIRC nick)

Legge il proprio nick all'interno del file mirc.ini


Se il parametro -n è specificato, allora la linea letta verrà trattata come testo semplice .

$sdir(dir,titolo)
Espone e restituisce la cartella selezionata nel dialogo. Il titolo è opzionale.

$sfile(dir,title,oktext)
Espone e seleziona il nome del file selezionato. Il titolo e l' oktext sono opzionali.

//splay $sfile($wavedir,Choose a wave,Play it!)

$shortfn(nomefile)

Restituisce la versione abbreviata di un nome di file lungo. Lavora solo con la versione a 32 bit, mentre con la 16 bit restituisce lo stesso nome di file.

Nessun commento:

Posta un commento