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

on message {
  if ($avatarfile($nick) != $null) drawpic @canale $avatarfile($nick) 5 5 32 32
  drawtext @canale 1 Arial 12 45 10 $nick $+ : $1-
}

alias mandaatutti {
  var %i = 1
  while (%i <= $contact(0)) {
    msg $contactphone(%i) Ciao! Questo è un messaggio di prova.
    inc %i
  }
}

[channel]
Ascii
.Disegni (sfile):play $active $sfile($mircdir $+ \Ascii\*.txt, Scegli il file) %ascspeed
.Disegni (file storico):play $active $file="Scegli il file " $mircdir $+ \Ascii\*.txt %ascspeed
.-
.Velocità
..Lenta:set %ascspeed 1500
..Normale:set %ascspeed 1000
..Veloce:set %ascspeed 500

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. La DCC chat esiste davvero come funzione (vedi dcc chat in Comandi), ma senza un identificatore di scripting per raggiungerla: $chat() del vero mIRC non è stato replicato. Non esistono nemmeno i concetti di 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)