Identificadores

 

            Identificadores.-

 

            El entorno del programa mIRC provee de una serie de identificadores o funciones que devuelven automáticamente un valor, para su uso en definiciones de alias, popups y eventos. Todos ellos están precedidos para que los identifiquemos por el símbolo “$”.

 

            Cuando el programa mIRC en la ejecución de un script, encuentra uno de estos identificadores, lo sustituye por el valor que este devuelve. Es importante tener en cuenta que estos identificadores deben de ir siempre especificados entre dos espacios en blanco, de lo contrario el programa no los identifica como tales (en las ultimas versiones del programa esto no es necesario, pero es un buen hábito que con toda seguridad nos ahorrará más de un problema cuando si nos acostumbramos a hacerlo así).

 

            Los identificadores están concebidos para su uso en rutinas de scripts, por tanto no funcionarán (no devolverán el valor correspondiente sino que serán interpretados literalmente) si los usamos en los comandos que introducimos directamente en la línea de escritura durante una sesión de irc. Este inconveniente, con el fin de realizar pruebas cómodamente, se puede anular de la siguiente forma: normalmente para mandar un comando a través de la línea de escritura lo hacemos anteponiendo el símbolo “/”, para que el programa lea lo que introducimos no como un comando simple sino como una orden de script lo haremos usando dos “/”, en este caso el programa si nos devolverá el valor correspondiente del identificador en ese momento.

 

            Un ejemplo sencillo sería el siguiente: //whois $me

 

            El identificador $me nos devuelve el nick que estemos usando en ese momento, por lo que sería igual que el hacernos un whois a nosotros mismos sea cual sea el nick que estemos usando.

 

Listado de identificadores.-

 

Identificadores de tiempo y fecha.-

 

Se trata de una colección de funciones que devuelven valores relativos a la duración y tratamiento de intervalos de tiempo.

 

 

            $ctime

 

            Devuelve el número total de segundos transcurridos desde las 0 horas del 1 de enero de 1970. Con este mismo identificador calcular los segundos transcurridos entre dos sucesos, o uno o el momento actual haciendo una simple resta y, luego transformándolo al formato de semanas /días/horas/minutos/segundos mediante el identificador $duration.

 

            $asctime(nº)

 

            Si el número es 0 devuelve el dato: “Thu 01 01:00:00 1970”, si introducimos otro número, éste se entenderá en segundos, y transformará al formato fecha/hora el instante que resulta de sumar esos segundos al momento: “Thu 01 01:00:00 1970”.

 

            Por ejemplo, si el Server nos informa de que una Gline fue establecida en 7523598147, podemos ver en formato mas comprensible la hora y la fecha que eso supone con la orden:

                        //echo –a $asctime(7523598147)

 

            $date

 

            Devuelve la fecha actual en formato: día/mes/año. Como ejemplo introduzca la siguiente orden:

                        //echo –a $date

 

            $adate

 

            Es igual a $adate, pero devuelve la fecha en formato americano, es decir: mes/días/año.

 

            $day

 

            Devuelve el nombre del día actual de la semana, en inglés.

 

            $duration(nº)

 

            Devuelve el número especificado de segundos transformado al formato: semanas/días/horas/minutos/segundos. Por ejemplo:

                        //echo –a $duration($ctime)

            Esta orden devolverá el tiempo transcurrido desde las 0 horas del día 1 de enero de 1970 hasta el momento presente, en formato semanas/dias/horas/minutos/segundos.

 

            $fulldate

 

            Devuelve la fecha en formato largo, por ejemplo: Thu May 13 22:15:45 2005

 

            $idle

 

            Devuelve nuestro tiempo actual idle, es decir, el tiempo transcurrido desde que enviamos el último mensaje al IRC.

 

            $ltimer

 

            Devuelve el número del último timer activado con el comando /timer

 

            $online

 

            Devuelve el número de segundos transcurridos desde que se puso a cero el reloj del contador del mIRC, es decir, los segundos transcurridos desde que nos conectamos en la sesión actual, o desde una fecha determinada, dependiendo de cómo tengamos configurado el dialogo TIMER (menú Tools).

 

            $ticks

 

            Devuelve el número de ticks desde que se inicio el sistema operativo. Esta es una unidad de medida propia del reloj de nuestro ordenador.

 

            $time

 

            Devuelve la hora actual en formato horas/minutos/segundos.

 

            $timer(0)

 

            Devuelve el número de timers activos en el momento actual.

 

            $timer(nº)[.propiedad]

 

            Devuelve todas las propiedades de timer cuyo número se especifica, número de repeticiones, retardo y tipo, etc. Las propiedades que podemos usar son: com, time, reps, delay, type.

 

            Por ejemplo:

                        $timer(nº).com

            Devuelve el comando o comandos asociados al timer especificado.

                        $timer(nº).type

            Devuelve el tipo de status del timer especificado: online/offline

 

            $timestamp

 

            Devuelve la hora actual en formato: [xx:xx]. Por ejemplo: [16:48]

 

Identificadores de números y textos.-

 

            Son funciones para el tratamiento aritmético de números y el manejo de cadenas de caracteres.

 

            $abs(nº)

 

            Devuelve el valor absoluto de un número, es decir, ese mismo número pero sin signo.

 

            $asc(caracter)

 

            Devuelve el número ASCII asociado al carácter que introduzcamos.

 

            $calc(operaciones)

 

            Devuelve el resultado de las operaciones especificadas. Es muy útil para realizar operaciones múltiples de una forma sencilla. Por ejemplo: $calc(3.14159 * (2 ^ %X % 3) – ($ticks / (10000 + 1)))

 

            El símbolo “^” representa la potencia, el asterisco el producto y “%” la dividion, “+” y “-“ representan la suma y resta respectivamente. No confundir el operador de la división con el símbolo “%” que precede a las variables (las cuales también se pueden incluir en esta expresión), en el caso de variables el símbolo precede inmediatamente al nombre de la variable, mientras que si se trata del operador de división tendrá siempre espacios en blanco a ambos lados.

 

            $chr(nº)

 

            Devuelve el carácter ASCII correspondiente al número especificado. Por ejemplo:

                        $chr(65)

            Devolverá el carácter A. Como se puede ver es la operación inversa a la que se realiza con el identificador $asc.

 

            $cos(N), $acos(N)

 

            Devuelven el coseno y arcoseno de un número.

 

            $tan(N) $atan(N)

 

            Devuelven la tangente y arcotangente de un número.

 

            $count(cadena_1,cadena_2)

 

            Devuelve el número de veces que la cadena_2 se encuentra repetida dentro de la cadena_1.

                        Por ejemplo: $cont(jajajaja,ja) à devolvera 5

 

            $int(nº)

 

            Devuelve la parte entera de un número sin redondear, por ejemplo:

                        $int(4.56148) à devolverá 4

 

            $left(cadena,N)

 

            Devuelve los N primeros caracteres de una cadena, por ejemplo:

                        $left(goodbye,5) à devolverá goodb

 

            $right(cadena,N)

 

            Devuelve los N últimos caracteres de una cadena, por ejmplo:

                        $right(tocados,4) à devolverá ados

 

            $len(cadena)

 

            Devuelve el número total de caracteres de una cadena incluidos los espacios en blanco que contenga.

 

            $lower(texto)

 

            Retorna todos los caracteres de una cadena convertidos a minúsculas, por ejemplo:

                        $lower(HOLA) à devolverá hola

 

            $mid(cadena,posición,número)

 

            Devuelve el número de caracteres de una cadena desde una posición dada. Por ejemplo:

                        $mid(saludos,3,4) à devolverá ludo

 

            $rand(valor1,valor2)

 

            Devuelve un número o letra aleatorio comprendido entre el rango [valor1-valor2], por ejemplo:

                        $rand(2,5) à devolverá cualquier número entre el 2 y el 5 incluidos ambos.

 

            $remove(cadena,sub_cadena)

 

            Devuelve la primera cadena, de la que se habrá suprimido la primera ocurrencia expresada en la sub_cadena, por ejemplo:

                        $remove(abcdefg,de) à devolverá abcfg

 

            $replace(texto,cadena,reemplazo)

 

            Busca una cadena dentro de un texto y la reemplaza por otra especificada, por ejemplo:

                        $replace(1234567,34,abc) à devolverá 12abc467

 

            $round(número,N)

 

            Devuelve un número especificado con solo los N primeros decimales, por ejemplo:

                        $round(3.14159,2) à devolverá 3.14

 

            $strip(texto)

 

            Devuelve un texto del que se habrán eliminado los posibles códigos de colores, negrita y subrayado.

 

            $str(texto,N)

 

            Devuelve un texto dado repetido N veces, ejemplo:

                        $str(la,3) à devolverá lalala

 

            $upper(texto)

 

            Devuelve un texto dado con todas las letras pasadas a mayúsculas.

 

Identificadores de ficheros y directorios.-

 

            Estas funciones permiten manipular y sacar información de nuestros ficheros y directorios de nuestro disco desde una sesión de mIRC, así como analizar aquellos que están relacionados con el programa mIRC.

 

            $alias(nº)

 

            Devuelve el nombre del n-esimo fichero de alias cargado en ese momento, si se especifica un 0 devolverá el número de ficheros alias que se encuentren cargados.

 

            Es posible asimismo especificar un nombre de fichero en lugar de un número, esto nos es de utilidad porque si el nombre especificado no se encuentra cargado nos devolverá $null, esto es útil de aprovechar en expresiones del tipo if-else.

 

            Ejemplos:

 

            $alias(0) à Devuelve el número total de ficheros alias cargados en ese momento.

            $alias(2) à Devuelve el nombre del segundo fichero de alias cargado en ese momento.

            $alias(saludo.ini) à Devuelve $null si el fichero de alias especificado (saludo.ini) no está cargado en ese momento.

 

            $dir, $sdir, $file y $hfile

 

            Presentan un cuadro de dialogo desde el que podemos seleccionar un fichero o directorio para ser utilizado dentro de la especificación de un alias, popup o rutinua de script. $dir presenta un dialogo desde el que se puede acceder a toda la estructura de ficheros y directorios del disco permitiendo escoger uno, mientras que $file presenta solo los ficheros de un directorio determinado; en ambos casos se puede especificar mediante el uso del comodín “*” que tipos de ficheros deseamos que aparezcan según sus extensiones. $hfile es igual a $file con la única diferencia que presenta los ficheros horizontalmente. $sdir permite seleccionar un directorio, es útil para casos en que no se desea que se especifique un fichero, sino tan solo un directorio.

 

            El formato es:

 

                        $dir[=”texto”] <path>

                        $file[=”texto”] <path>

                        $hfile[=”texto”] <path>

                        $sdir[=”texto”] <path>

 

            Por ejemplo podemos definir una opción de popups que reproduzca los ficheros del tipo mid que hay dentro de un directorio llamado “midis”, del que podremos seleccionar el que deseemos:

                        Música midi:splay $file=”Selecciona la música” c:\midis\*.mid

 

            Es de utilidad el poner un símbolo $ adicional (dos en total) delante de identificador, así si no se selecciona ningún fichero o directorio el comando no se ejecutará, en caso contrario nos devolvería un error de parámetro no especificado.

 

            $exists(fichero)

 

            Devuelve $true si el fichero existe y $false si el fichero no existe, es de utilidad para instrucciones del tipo if-else.

 

            $findfile(directorio,tipo_de_fichero_número)

 

            Busca en el directorio especificado (y en todos los subdirectorios si los hubiere) todos los ficheros de un determinado tipo y presenta el path y el nombre del que tiene el número de orden indicado; si el número es 0 presentará toda la lista de ficheros encontrados de ese tipo. Por ejemplo:

                        $findfile(c:\mirc,*.exe,1) à Presentará c:\mirc\mirc.exe

                        $findfile(C\,auto*.*,1) à Presentará: c:\autoexec.bat

 

            $getdir

 

            Devuelve el directorio que tengamos especificado en el dialogo DCC options, como destino por defecto para las recepciones DCC.

 

            $getdir(tipo_fichero)

 

            Devuelve el directorio que tengamos especificado en el dialogo DCC options, como destino para los recepciones DCC de ficheros del tipo especificado, por ejemplo:

                                   $getdir(*.txt)

 

            $lines(fichero)

 

           

            Devuelve el número de líneas que tiene un fichero de texto, por ejemplo:

                        $lines(c:\irc\kicks.txt) à Presentará el número de líneas del fichero c:\irc\kicks.txt

 

            $lof(fichero)

 

            Devuelve el tamaño en bytes de un fichero especificado.

 

            $logdir

 

            Devuelve el directorio especificado en la sección Log del dialogo file/options, es decir, el directorio donde se guardaran las copias (logs).

 

            $mididir

 

            Devuelve el directorio especificado para los ficheros midi en la sección sound request del dialogo file/options, es decir, aquel en el que mIRC buscará un fichero de extensión mid ante un requerimiento ctcp midi.

 

            $nofile(fichero)

 

            Devuelve el path o ruta de un fichero especificado, por ejemplo:

                        $nofile(c:\mirc\mirc32.exe) à devolverá c:\mirc\

 

            $nopath(ruta y fichero)

 

            Devuelve el nombre del fichero especificado sin incluir el path, por ejemplo:

                        $nopath(c:\mirc\mirc.exe) à devolverá mirc.exe

 

            $mircdir

 

            Devuelve el path donde se encuentra actualmente el programa miRC.

 

            $mircini

 

            Devuelve el nombre del fichero .ini principal del directorio donde se encuentra el mIRC. Este es normalmente mirc.ini.

 

            $read

 

            Lee una línea aleatoria de un fichero de texto, y la inserta dentro del alias en que se esté utilizando, interpretando esta línea como un comando de mIRC, su formato es:

                        $read [-nl<número>] [-s<texto>] <fichero>

 

            El parámetro “-l<número>” permite especificar un número concreto de línea del fichero.

            El parámetro “-n” permite interpretar literalmente la línea, no como un comando.

            El parámetro “-s<texto>” devuelve la primera línea que comience por el texto especificado.

 

            Ejemplos:

                                   /say $read c:\besa.txt

                        Imprimirá en pantalla una línea aleatoria del fichero c:\besa.txt

                                   /say $read –l5 c:\saludo.txt

                        Imprimirá la línea 5 del fichero c:\saludo.txt

                        /pateo /pick # $1 $read kicks.txt

            Hará un kick de nick especificado dando como razón una línea elegida al azar del fichero “kicks.txt”

                        /say $read –smirc info.txt

            Busca una línea dentro del fichero “info.txt” que comience por “mirc”, e imprime en pantalla el resto de la línea.

 

            NOTA.- Si la primera línea del fichero de texto es un número el programa entenderá que representa el número total de líneas del fichero y esto acelerará la ejecución de $read. En caso de que se especifique el 0 como número de línea y la primera línea de ellas sea un número, el identificador devolverá dicho número.

 

            $readini

 

            Lee información de un fichero .ini e inserta la fila correspondiente dentro del alias para su interpretación como un comando. El formato es:

                        $readini <-n><fichero> <sección> <item>

 

            Ejemplo:

                        /echo $readini mirc.ini mIRC nick

 

            Presentará nuestro nick tomándolo del fichero mirc.ini

 

            El parámetro “-n” permite interpretar literalmente la línea, no como un comando.

 

            $script(N/fichero)

 

            Devuelve el nombre del n-esimo fichero de script cargado. Si se especifica un nombre de fichero de script en lugar de un número, devolverá este mismo nombre o $null si dicho fichero no se encuentra cargado.

 

            Ejemplos:

                        $script(0) à devuelve el número total de ficheros de script cargados.

                        $script(3) à devuelve el nombre del tercer fichero de script.

                        $script(lista.txt) à devuelve $null si el fichero no está cargado o lista.txt si lo está.

 

            $wavedir

 

            Devuelve el directorio especificado para los ficheros wav en la sección sound request del dialogo file/options.

 

Identificadores de nicks y direcciones-

 

            Algunas de las funciones más interesantes del mIRC se encuentra aquí, una recopilación de identificadores útiles para el manejo y automatización de labores relacionadas con los nicks y su dirección de conexión al IRC e Internet.

 

            $address(nick,tipo)

 

            Busca en la lista interna de direcciones la dirección asociada el nick especificado, los tipos son los que se describen en el identificador $mask. Por ejemplo:

                        $address(nick,1) à devuelve el formato: nick!user_id@dominio.host

            Si la lista interna no contiene el nick especificado, o se encuentra desactivada, se devolverá $null.

 

            $comchan(nick,nº)

 

            Devuelve los canales en que nos encontremos nosotros junto al nick especificado. Por ejemplo:

                        $comchan(nick,0) à devuelve todos los canales en que nos encontremos nosotros y ese nick.

                        $comchan(nick,1) à devuelve el primer canal en que nos encontremos nosotros y ese nick.

 

            $ial([máscara,nº])[.propiedad]

 

            Devuelve direcciones de la lista interna de direcciones. Propiedades: nick, user, host, addr. Ejemplos:

                        $ial(*!*@*.demon.co.uk,0) à devuelve todas las direcciones que concuerden con la mascara especificada.

                        $ial(*!*@*.demon.co.uk,2) à devuelve la segunda mascara que concuerde con la especificada.

                        $ial(*!*@*.com,0).nick à devuelve el nick que concuerde con la mascara.

                        $ial(*!*@*.com,4)user à devuelve el user_id que concuerde con la mascara.

 

            Para mostras todas las direcciones de la lista interna se puede usar: $ial(*,0).

 

            $ialchan(máscara,#canal,nº)

 

            Igual al anterior pero solo referido a la lista de ocupantes de un canal determinado.

 

            $level(address)

 

            Busca dentro de nuestra lista de acceso remoto el usuario con la dirección especificada y devuelve su level de accesso.

 

            $link(N)[.propiedad]

 

            Devuelve el n-esimo server de la lista de servidores enlazados en la actual red de IRC. Propiedades: addr, ip, level, info. Ejemplos:

                        $link(0) à devuelve el número de servers enlazados.

                        $link(1) à devuelve el primer servidor de la lista de links.

 

            $longip(address)

 

            Convierte una dirección ip en su formato entero largo y viceversa.

 

            $maddress(máscara)

 

            Busca en la lista interna de usuarios y devuelve la dirección del primer usuario que corresponda con la mascara especificada.

 

            $mask(dirección,tipo)

 

            Devuelve la máscara correspondiente al tipo especificado para una dirección dada. Por ejemplo:

                        $mask(nick!pato@madam.demon.co.uk,1)

            Devolverá: *!pato@madam.demon.co.uk

                        $mack(nick!pato@madam.demon.co.uk,2)

            Devolvera: *!*@madam.demon.co.uk

 

            Los tipos de máscara aplicables son:

 

·          0: *!user_id@host.dominio

·          1: *!*user_id@host.dominio

·          2: *!*@hot.dominio

·          3: *!*user_id@*.dominio

·          4: *!*@*.dominio

·          5: nick!user_id@host.dominio

·          6: nick!*user_id@host.dominio

·          7: nick!*@host.dominio

·          8: nick!*user_id@*.dominio

·          9: nick!*@*.dominio

 

La utilidad de este identificador es su uso en otros identificadores y comandos.

 

            $me

 

            Devuelve nuestro actual nick.

 

            $nick(#canal,N)

 

            Devuelve el n-esimo nick de la lista de nicks del canal especificado, si ponemos 0 nos devolverá en número los ocupantes del canal.

 

            $nopnick(#canal,N)

 

            Igual a los anteriores pero referido a los nicks de nuestra lista de notificaciones, además tiene las propiedades: note, sound, whois.

 

            $vnick(#canal,N)

 

            Igual que los anteriores pero referido a los nicks que tengan voz en el canal especificado.

 

            $opnick(#canal,N)

 

            Igual que los anteriores pero referido a los nicks que tengan status de operadores del canal.

 

            $snicks

 

            Devuelve en una línea, separados por comas, todos los nicks que tengamos seleccionados de la lista de nicks del canal.

 

Identificadores token.-

 

            Se trata de un grupo de funciones con una finalidad muy especifica: el tratamiento de cadenas de caracteres, considerándolas como una serie de elementos individuales separados todos ellos entre sí por un carácter concreto. Veamos los de mayor uso:

 

            $addtok(cadena,elemento,separador)

 

            Añade un elemento al final de la serie, por ejemplo, hemos creado una variable conteniendo una serie de nombres:

                        set %amigos Juan pepe diego

            Desde este momento es indistinto usar la variables %amigos en el identificador o especificar la cadena completa: Juan pepe diego. Para el identificador no es más que una serie de elementos separados por un especio en blanco. Podemos usarlo para añadir un nuevo elemento a la variable separado de los demás por un espacio en blanco, haciendo:

                        $addtok(%amigos,pedro,32)

            Ahora la variable contendrá: Juan pepe diego pedro. Podemos verlo fácilmente con una orden que nos lo imprima en la ventana de estado:

                        /echo –s %amigos

 

            $instok(cadena,elemento,posición,serparador)

 

            Es similar al anterior, permite añadir un elemento a la cadena, pero insertándolo en la posición que deseemos en lugar de al final de esta. Si especificamos una posición superior a la última lo añadirá al final de la serie. Por ejemplo:

                        $instok(1 2 3 4 5,R,3,32) à devolverá: 1 2 R 3 4 5

 

            $puttok(cadena,elemento,posición,separador)

 

            Sustituye el elemento que se encuentra en una determinada posición por el que nosotros le especifiquemos.

 

            $deltok(cadena,posición,separador)

 

            Devolverá la cadena, de la que se habrá eliminado el elemento que se encuentre en una determinado posición.

 

            $gettok(cadena,posición,separador)

 

            Nos devuelve el elemento de la cadena que se encuentra en una determinada posición, si la posición es superior a la última nos devolverá $null. Por ejemplo:

                        $gettok(Juan Antonio pedro luis,2,32) à devolverá: Antonio

 

            Si en lugar de posición ponemos el valor 0 nos devolverá el número de elementos de la cadena.

 

            También podemos indicar un rango de posiciones, es decir, pedir todos los elementos entre dos posiciones dadas, o una posición y el final:

                        $gettok(a.b.c.d.e,2-,46) à devolverá desde la segunda hasta el final: b.c.d.e

                        $gettok(a.b.c.d.e,2-4,46) à devolvera los elementos del 2º al 4º: b.c.d

 

            $findtok(cadena,elemento,número,separador)

 

            Nos devolverá la posición en la que se encuentra el elemento especificado dentro de la cadena, si el elemento no se encuentra devolverá $null.

 

            El número sirve para señalarle a la función, en el caso de que encuentre más de un elemento igual al señalado, a cual de ellos nos referimos. Por ejemplo:

                        $findtok(a b c c d c,c,3,32)

            Este ejemplo nos devolverá: 6; es decir, la posición del tercer carácter “c” dentro de la cadena.

 

            $remtok(cadena,elemento,número,separador)

 

            Buscará dentro de la cadena un elemento igual al especificado, si hay varios elegirá el que hace el número especificado de orden que indicamos y nos devolverá la misma cadena después de haber eliminado este.

 

            $reptok(cadena,elemento,nuevo_elemento,número,separador)

 

            Buscará dentro de la cadena un elemento igual al indicado, si hay varios elegirá el que hace el número de orden que indicamos, sustituirá este elemento por uno nuevo especificado y nos devolverá la cadena resultante.

 

Identificadores de ventanas.-

 

            Funciones que nos informan acerca de distintos aspectos referidos a las distintas ventanas abiertas en la sesión de mIRC, ya sean de canal, chat privados, servidor de ficheros, etc.

 

            $active

 

            Devuelve el nombre de la ventana activa.

 

            $appactive

 

            Devuelve $true si mIRC es la aplicación activa en ese momento y $false si no lo es.

 

            $chan(N\#canal)[.propiedad]

 

            Devuelve información sobre los canales en los que nos encontremos. Propiedades: topic, mode, key, limit.

 

            Si se especifica un número en vez de un canal devuelve el nombre de ese canal, ejemplos:

                        $chan(0) à devuelve el número de canales en que nos encontramos.

                        $chan(2) à devuelve el nombre del segundo canal en que nos encontramos.

                        $chan(2).key à devuelve la clave del segundo canal en que nos encontremos.

 

            También podemos especificar un nombre de canal, pero sólo devuelve información sobre este si nos encontramos dentro de el.

                        $chan(#mIRC).mode à devuelve los modos del canal #mIRC.

 

            $chat(N\nick)[.propiedad]

 

            Devuelve información sobre las ventanas de dcc chat abiertas. Popiedades: ip, status. Por ejemplo:

                        $chat(2).ip à devuelve la ip del segundo dcc chat activo.

 

            $fserv(N\nick)

 

            Devuelve información sobre las ventanas abiertas del servidor de ficheros. Propiedades: ip, status, cd (directorio abierto).

 

            $get(N\nick)[.propiedad]

 

            Devuelve información sobre los dcc get en curso (recepción de ficheros). Propiedades: ip, status, file, size, rcvd, cps, pc. Ejemplos:

                        $get(0) à devuelve el número de dcc gets en curso.

                        $get(2) à devuelve el nick que envía el segundo dcc get activo.

                        $get(2).rcvd à devuelve el número de bytes recibidos hasta el momento en el segundo dcc get.

                        $get(2).cps à devuelve el nº de caracteres por segundo que se están recibiendo en el segundo dcc get.

                        $get(3).pc à devuelve el porcentaje transmitido en el tercer dcc get.

 

            $query(N\nick)[.address]

 

            Devuelve el nick o la dirección del enesimo query abierto. Propiedad: address. Ejemplos:

                        $query(0) à devuelve el número de querys abiertos.

                        $query(2) à devuelve el nick del segundo query.

                        $query(1).address à devuelve la dirección del primer query.

 

            $send(N\nick)[.propiedad]

 

            Devuelve información sobre los envíos de ficheros en curso (dcc,sends). Propiedades: ip, status, file, size, sent, cps, pc.

 

            Ejemplos:

                        $send(0) à devuelve el número de ficheros que se están enviando.

                        $send(2) à devuelve el nick de destino del segundo envío.

                        $send(1).sent à devuelve el nº de bytes enviados en el primer dcc en curso.

                        $send(3).pc à devuelve el porcentaje transferido en el tercer envío en curso.

                        $send(3).status à devuelve el estado (activo, inactivo o en espera) del tercer envío en curso.

 

Identificadores diversos.-

 

            Especificaremos algunas funciones no relacionadas anteriormente.

 

            $away

 

            Devuelve el valor $true (verdadero) o $false (falso) si estamos en estado de away o no.

 

            $bits

 

            Devuelve 16 o 32, según tengamos la versión de 16 o 32 bits de mIRC.

 

            $cb

 

            Devuelve los primeros 256 caracteres contenidos en el portapapeles.

 

            $cr

 

            Devuelve el carácter de retorno del carro. Es equivalente a poner: $chr(13)

 

            $editbox(window)

 

            Devuelve el texto contenido en la caja de edición (línea de escritura) de una determinada ventana.

 

            $host

 

            Devuelve el nombre del actual Local host.

 

            $ignore(N)[.type]

 

            Devuelve la dirección del enésimo elemento de la lista de ignores. Ejemplos:

 

                        $ignore(0) à devuelve el número de elementos incluidos en la lista de ignores.

                        $ignore(1) à devuelve la dirección del primer elemento de la lista de ignores.

                        $ignore(2).type à devuelve el flan del segundo elemento de la lista de ignores, es decir, el tipo de ignore impuesto: a los querys, a los dcc, etc.

 

            $ip

 

            Devuelve nuestra dirección ip.

 

            $lf

 

            Devuelve el carácter de salto de línea, equivale a $chr(10)

 

            $usermode

 

            Devuelve nuestros actuales modos de usuario.

 

            $version

 

            Devuelve la versión del mIRC en uso.

 

            $+

 

            Este identificador insertado en una línea de instrucción eliminará el espacio en blanco que se encuentra a su derecha y también el que se encuentra a su izquerda.

 

            $(número)

 

            Se puede usar $1 $2 … $N para referirse a los parámetros o palabras individuales de una línea de comando. Además es posible especificar $n1- para referirse al parámetro o palabra de la posición especificada y todos los que le siguen, y tambien $nº_1-nº_2 para referirse a todas las palabras comprendidas entre dos posiciones especificadas.

 

            $address

 

            Devuelve la dirección de un usuario asociado a un evento, en la forma: *!user_id@host.dominio

 

            $fulladdress

 

            Devuelve la dirección de un usuario asociado a un evento en la forma: nick!user_id@host.dominio

 

            $group(N\#nombre)[.status]

 

            Devuelve el nombre o estatus de un grupo de un script. Ejemplos:

                        $group(0) à devuelve el número de grupos del script

                        $group(1) à devuelve el nombre del primer grupo del script.

                        $group(1).status à devuelve el estatus del primer grupo: on o off.

                        $group(#name) à devuelve el estatus del grupo #name

 

            $nick

 

            Devuelve el nick de un usuario asociado a un evento.

 

            $ulevel

 

            Devuelve el nivel de acceso remoto de un usuario asociado a un evento.