Identificatori e funzioni

Gli identificatori ($qualcosa) vengono sostituiti col loro valore prima che una riga di script (o un comando digitato con //) venga eseguita.

Argomenti

Contesto (chi/dove/cosa)

Media (aggiunta nostra - IRC non ha allegati)

Notifiche (aggiunta nostra)

Percorsi (come nel vero mIRC)

Costanti (identificatori nudi, come nel vero mIRC)

Manipolazione token

Un "token" è un pezzo di testo separato da un carattere scelto da te (di solito uno spazio) - queste funzioni dividono/ricompongono liste di questo tipo. Come nel vero mIRC, il separatore C è sempre un codice ASCII (es. 32=spazio, 46=punto), non il carattere stesso - assente, vale spazio.

Le funzioni che confrontano il CONTENUTO di un token (non solo la posizione) hanno anche una variante ...cs (case-sensitive), stessi parametri: $addtokcs, $findtokcs, $istokcs, $matchtokcs, $remtokcs, $reptokcs, $sorttokcs, $wildtokcs. $gettok/$deltok/$instok/ $numtok/$puttok non hanno una variante cs perché lavorano solo per posizione, il maiuscolo/minuscolo non li riguarda.

$gettok(a.b.c.d.e,3,46)      ; c
$gettok(a.b.c.d.e,2-,46)     ; b.c.d.e
$addtok(a.b.c,d,46)          ; a.b.c.d
$deltok(a.b.c.d,2-3,46)      ; a.d
$istok(a.B.c,b,46)           ; 1 (case-insensitive: B conta come b)
$istokcs(a.B.c,b,46)         ; 0 (case-sensitive: B non è b)

Data/ora con parametri, matematica, validazione

File e hash

Versione semplificata rispetto al vero mIRC (che ha molti più switch/opzioni per ognuna di queste).

Vedi anche Comandi per fopen/fclose/fwrite, e le costanti $feof/$ferr qui sopra.

Variabili binarie (Binary Files)

Versione semplificata rispetto al vero mIRC. Vedi Comandi per bread/ bwrite/bset/bunset/bcopy/breplace/btrunc, che creano e modificano le variabili binarie &nome lette da queste funzioni.

bset &v 1 72 101 108 108 111    ; &v = "Hello" in byte
$bvar(&v,1,5)                   ; 72 101 108 108 111
$bfind(&v,1,101)                ; 2 (posizione della "e")
$bfind(&v,1,ello)               ; 2

Socket (Sockets)

Vedi Comandi per sockopen/sockwrite/sockread/ sockclose/sockmark, e le costanti $sockname/$sockerr/ $sockbr qui sopra.

Funzioni di testo/numeri

alias cambianick {
  var %nuovonick = $input(Inserisci il nuovo nickname:, e, Cambia Nickname, $me)
  if (%nuovonick != $null) {
    /nick %nuovonick
  }
}

; /away è un comando vero (vedi sezione "Away/idle" sotto) - l'avviso a chi
; ti scrive mentre sei via lo manda già l'app da sola, non serve scriverlo:
alias setaway {
  var %frase = $input(Frase da mostrare se ti scrivono mentre sei via:, e, Imposta Away)
  if (%frase != $null) {
    away %frase
  }
}

set %i 1
while (%i <= $nick(0)) {
  echo $nick(%i)
  inc %i
}

echo $+(Ciao, ,$nick,!)   ; niente spazi indesiderati tra i pezzi

Vedi anche Dialogs per $did()/$dialog()/$didtok()/ $didwm()/$didreg()/$dbuw/$dbuh, e i comandi /dialog//did//didtok; e Custom Windows per $window()/$line()/$fline()/$flinen, e i comandi /window//aline//cline//dline//iline//rline/ /sline//renwin.

Window Identifiers

Dalla documentazione ufficiale mIRC (window_identifiers.html): qui è stato implementato solo il sottoinsieme che ha un vero equivalente in questa app. Non esistono i concetti di DCC chat separata, file server, "finestra query unica" ($compact), modalità a schermo intero ($fullscreen) o stato dell'applicazione ($appactive/$appstate) - quindi $chat(), $compact, $dqwindow, $fserve(), $fullscreen, $appactive, $appstate, $lactive e $lactivewid non sono stati replicati.

echo Finestra attiva: $active ($activewid) - sono in $wid
echo Gruppi aperti: $chan(0)
if ($chan(0) > 0) echo Il primo è $chan(1), id $chan(1).wid
echo Chat private aperte: $query(0)
if ($send(0) == 1) echo Invio in corso: $send(1).file al $send(1).pc%
echo Messaggi caricati in #canale: $msg(#canale,0)
if ($msg(#canale,3).type == video) echo Il terzo messaggio è un video, id $msg(#canale,3).id

Codici di controllo (grassetto, colore, sottolineato...)

Gli stessi codici di controllo del vero mIRC, inseribili con $chr(N) dentro qualunque testo (messaggi, comandi say/echo, righe di Custom Window). Vengono visualizzati davvero in modalità testo semplice (MESSAGE_FORMAT=text nelle Opzioni) - in modalità HTML non si applicano, quella modalità usa la formattazione nativa di Telegram/WhatsApp, un sistema diverso e non correlato.

say $chr(2)Attenzione!$chr(2) Questo è $chr(3)4rosso$chr(15) e questo $chr(31)sottolineato$chr(31).

Ctrl+K (come nel vero mIRC): apre una tavolozza dei 16 colori direttamente nella casella di testo di qualunque finestra - clicca un colore per inserirlo alla posizione del cursore, senza dover scrivere $chr(3) a mano. Solo il colore di primo piano (il vero mIRC permette anche lo sfondo con un secondo click); per lo sfondo si può comunque scrivere ,MM subito dopo a mano.

Away / idle

; auto-away dopo 10 minuti di inattività, controllato ogni 60 secondi
on start { timer99 0 60 { if ($idle >= 600) && (!$away) { away Assente da un po', torno presto } } }

Altri identificatori

echo $count(hello world hello,hello) occorrenze di "hello"
echo $bytes($nick(0))                 ; ovviamente senza senso, solo per l'esempio
echo Oggi è il $asctime(dd/mm/yyyy) alle $asctime(hh:nn:ss)
echo File: $nopath(%percorso) in $nofile(%percorso)