Programmation mIRC/Autres Identifieurs

$+(n1,...,nN)

Combine tous les paramètres spécifiés, même chose en utilisant $+ entre chaque item.

$?*!="message"

Demande à l'utilisateur une entrée et retourne le résultat.

//Echo -a $?="Quel est votre nom ?"

Si l'utilisateur entre leur nom dans la boite d'édition et presse le bouton OK, $? Retournera ce que l'utilisateur a entré. Si l'utilisateur clique sur le bouton Cancel, $? Retourne rien.

//Echo -a $?*="Quel est votre mot de passe ?"

Dans ce cas, le $?* transforme tout le texte que l'utilisateur tape en caractères ***** pour empêcher quiconque regardant ce qui est entré.

//Echo -a $?!="Continue-je?"

Dans ce cas, un dialogue Yes/No apparaît. Si l'utilisateur clique sur Yes, $true est retourné, autrement $false est retourné. Le dialogue d'entrée est étendu verticalement pour afficher le message en entier s'il est très long. Vous pouvez également faire apparaître différentes lignes en utilisant l'identifieur $crlf pour séparer les lignes par exemple.

$?="C'est la première ligne. $crlf $+ Et c'est la seconde ligne."

Note : Cet identifieur ne peut pas être utilisé dans un évènement de script. /timer permet d'initier une requête d'entrée à la fin des scripts.

$ansi2mirc(texte)

Retourne le texte avec les codes ANSI converti en codes couleur mIRC.

$away

Retourne la valeur $true ou $false selon si vous êtes marqué away ou non.

Vous pouvez également utiliser $awaymsg et $awaytime pour retourner vos réglages away actuels. .

$cb

Retourne les 256 premiers caractères du contenu du bloc-notes.

$cb(N)

Retourne les lignes délimitées de $crlf du texte actuellement dans le bloc-notes.

Retourne ce qu'il y a dans le clip board

Propriétés : len

$cb(0) retourne le nombre de lignes dans le bloc-notes
$cb(0).len retourne la longueur totale de toutes les lignes dans le bloc-notes
$cb(1) retourne la ligne 1 du bloc-notes
$cb(1).len retourne la longueur totale de la ligne 1

$chantypes

mIRC supporte le token numérique 005 CHANTYPES, et peut gérer un groupe dynamique de préfixes de salon.

$chantypes retourne la liste des préfixes de salon qui peuvent être joint, par exemple #mIRC, &mIRC.

Quand on n'est pas connecté au serveur, mIRC utilise une valeur $chantypes par défaut (à savoir CHANTYPES=#&.)

$chanmodes

mIRC supporte le token numérique 005 CHANMODES, et peut gérer un groupe dynamique de modes de salon.

$chanmodes retourne la liste des modes du salon supportés, par exemple '+k moo' pour régler la clé du salon à 'moo'.

Quand on n'est pas connecté au serveur, mIRC utilise une valeur $chanmodes par défaut (à savoir CHANMODES=bIe,k,l.)

$cmdbox

Retourne $true si une commande ou script a été initiée via la boite d'édition dans une fenêtre salon.

$cmdline

Retourne la ligne de commande qui a été passée à mIRC quand il a été exécuté.

$color(nom/N)

Retourne le Nième index de la couleur spécifiée, par exemple $color(action text). Si vous ne spécifiez pas le nom complet, la première correspondance est retournée, par exemple $color(action)

Si vous spécifiez une valeur N, retourne la valeur RGB de la Nième boite de couleur.

Propriétés : dd

$color(action).dd retourne le nombre sous le format deux digits

$cr

Retourne le caractère carriage return, le même que $chr(13).

$creq

Retourne les réglages actuels de /creq dans les le dialogue Options, section Option, partie On send request.

$crlf

Retourne une combinaison carriagereturn/linefeed.

$dccignore

Retourne $true si les types d'ignore sont activés dans le dialogue Ignore DCC, autrement retourne $false.

$dccignore(N/nom de fichier)

Retourne le Nième item dans la boite d'édition Types dcc ignorés dans le dialogue DCC Folders.

Si N est zéro, retourne le nombre d'items dans la liste, autrement retourne le Nième item dans la liste. Si un nom de fichier est spécifié, retourne $true s'il correspond à l'item dans la liste, autrement $false.

$dccport

Retourne le port en cours d'utilisation par le DCC Server.

$dll(nom.dll,procname,data)

Retourne la valeur résultant d'un appel à une DLL conçue pour travailler avec mIRC.

$editbox(fenêtre,N)

Retourne le texte dans une boite d'édition de la fenêtre spécifiée.

Si N = 1, retourne le texte dans la seconde boite d'édition d'une fenêtre salon si elle est ouverte.

$emailaddr

Retourne le courriel spécifié dans le dialogue de connexion.

$eval(texte,N)

Evalue le contenu du texte N fois. Si N n'est pas spécifié, le défaut est N = 1. Si N est zéro, le texte n'est pas évalué.

Cela vous permet d'évaluer de manière récursive les identifieurs et variables dans une ligne de texte.

$fullname

Retourne le nom complet spécifié dans le dialogue de connexion.

$hash(texte,B)

Retourne un nombre haché basé sur le texte où B est le nombre de bits utilisés lors du calcul du nombre haché.

$highlight

Retourne $true si le clignotement est activé dans le dialogue Highlight, sinon retourne $false.

$highlight(N/texte)

Retourne la Nième ligne dans la liste de clignotement ou si le texte est spécifié, retourne les propriétés de la ligne de clignotement qui correspond au texte.

Propriétés : text, color, sound, flash, message, nicks, cs

$host

Retourne votre nom d'hôte local.

$iif(C,T,F)

Retourne T ou F selon si l'évaluation du conditionnel C est vrai ou fausse.

$iif(1 == 2, yes, no)

-> retourne "no"

$iif() retourne F si le conditionnel retourne zéro, $false ou $null. Pour tout autre valeur $iif() retourne T.

Si vous ne spécifiez pas le paramètre F, $iif retourne une valeur T si la condition est vraie, et ne retourne rien s'il est faux.

$iif(1 == 2, yes)

-> ne retourne rien

Vous pouvez en savoir plus sur les conditionnels dans la section if-then-else.

$ignore(N/adresse)

Retourne la Nième adresse dans la liste d'ignore.

Propriétés : type, secs

$ignore(0) retourne le nombre total d'adresses dans la liste d'ignore
$ignore(1) retourne la 1ère adresse dans la liste d'ignore
$ignore(2).type retourne les drapeaux d'ignore pour la 2ème adresse dans la liste d'ignore
$ignore(2).secs retourne le nombre de secondes jusqu'à ce que l'ignore soit enlevé si /ignore -uN a été utilisé

Note : Si vous spécifiez une adresse, la première adresse correspondante dans la liste d'ignore est retournée.

$inpaste

Retourne $true si un utilisateur a tapé Contrôle+V ou Shift+Insérer pour coller le texte dans une boite d'édition. Très utile lors du traitement d'un événement on INPUT.

$input(prompt,N,fenêtre,titre,texte) (pour fenêtre)

Demande à l'utilisateur à entrer pour retourner le résultat.

Le dialogue d'entrée est étendu verticalement pour afficher le message s'il est très long. Vous pouvez également faire que le texte dans le message apparaisse sur différentes lignes en utilisant l'identifieur $crlf pour séparer les lignes.

N peut être une combinaison des options suivantes :

e montre la boite d'édition d'entrée
p montre la boite d'édition d'entrée de mot de passe
o bouton ok
y boutons yes no
n boutons yes no cancel
r boutons retry cancel
v retourne $ok, $yes, $no, $cancel pour les boutons.
g Boutons alignés sur la droite

Par défaut, les boutons retournent $true ou $null, idem que $?. S'il y a une boite d'édition d'entrée, les boutons ok/yes retournent toujours les contenus de la boite d'édition.

N peut aussi contenir une des options suivante (ou pas) pour spécifier l'icone à afficher :

i Icone "info"
q Icone "question"
w Icone "warning"
h Icone "hand"

Si une option d'icone a été spécifiée, on peut alors utiliser cette option :

d joue un son système associé à cet icône.

D'autres options sont aussi disponibles :

s indique que ce nom de fenêtre a été spécifié
a active le dialogue
u utilise la fenêtre active en cours comme fenêtre parent

titre Le texte de la barre de titre.

texte Le texte par défaut placé dans la boite d'édition d'entrée.

N, fenêtre, titre, et texte sont des paramètres optionnels.

Note : Cet identifieur ne peut pas être utilisé dans un évènement de script. Un moyen le contournant est d'utiliser un /timer pour initier une requête d'entrée après que le script se finisse.

$ip

Retourne votre adresse IP.

$isalias(nom)

Retourne $true si le nom spécifié est une commande alias qui existe dans vos alias ou scripts.

Propriétés : fname , alias

$isalias(join) retourne $true si vous avez un alias pour /join
$isalias(join).fname retourne le nom de fichier dans lequel l'alias existe
$isalias(join).alias retourne la définition de l'alias pour /join

$isid

Retourne $true si un alias a été appelé comme identifieur, autrement $false.

$lf

Retourne le caractère linefeed, le même que $chr(10).

$lock(item/#/N)

Retourne $true ou $false pour les réglages lock sur les items dans le dialogue Lock.

Propriétés : send, get, chat, fserve, run, dll, channels

Vous pouvez également utiliser $lock(N) où N retourne le Nième salon dans la liste des salons limite ou vous pouvez spécifier un nom de salon au lieu de N.

$md5(texte|&binvar|nom de fichier,[N])

Retourne la valeur hachée md5 aux données spécifiées où :

N = 0 pour du texte normal (défaut), N = 1 pour &binvar, N = 2 pour nom de fichier.

$modespl

mIRC supporte MODES du token numérique 005.

$modespl retourne le nombre maximum de paramètres permis selon /mode, par exemple si $modespl est égal à 5, vous pouvez utiliser /mode +ooooo pour mettre cinq modes à la fois.

$network

Retourne le nom du réseau IRC où vous êtes actuellement connecté.

Note : Il n'est pas possible d'obtenir cette information si un réseau ne le fournit pas.

Note : mIRC obtient le nom le nom du réseau IRC où vous êtes sur le numérique 001, par exemple "Welcome to the N Internet Relay Network", où N est le nom du réseau. S'il ne peut pas trouver le nom du réseau (Certains réseaux IRC n'ont pas cette info), il utilise le nom du groupe du serveur s'il est dans votre liste de serveurs IRC.

Le nom du réseau est utilisé pour sélectionner le nom de fichier correct dans le dialogue List Channels, par exemple si vous vous connectez à un serveur DALnet, mIRC sélectionnera automatiquement le fichier de la liste des salons appelé dalnet.txt.

$os

Retourne le numéro de version du sytème d'exploitation. La réponse peut être 95, 98, NT, ME, 2K, XP, ou NET.

$port

Retourne le numéro du port du serveur auquel vous êtes actuellement connecté.

$prefix

mIRC supporte PREFIX du token numérique 005, et peut gérer un groupe dynamique des préfixes du pseudonyme du salon.

$prefix retourne la liste des préfixes du pseudonyme du salon, par exemple op, halfop, voice, etc. qui sont supportés par le serveur.

Lorsque non connecté au serveur, mIRC utilise une valeur $prefix par défaut de PREFIX=(ohv)@%+.

$result

Garde la valeur retournée à la routine appelant par la commande /return.

$rgb(nom)

Retourne la valeur RGB du nom de la couleur système spécifiée qui peut être l'une des suivantes : face , shadow , hilight , 3dlight , frame , et text .

$server

Retourne le nom du serveur auquel vous êtes actuellement connecté.

Si vous n'êtes pas connecté au serveur, il retourne $null.

$server(N/adresse)

Retourne l'adresse du Nième serveur dans votre liste de serveurs IRC.

Propriétés : desc, port, group, pass

$server(0) retourne le nombre total de serveurs dans la liste des serveurs
$server(2) retourne l'adresse du 2ème serveur
$server(2).desc retourne la description du 2ème serveur
$server(3).port retourne le(s) port(s) du 3ème serveur
$server(3).pass retourne le mot de passe du 3ème serveur
$server(2).group retourne le nom de réseau du 2ème serveur

Si vous spécifiez une adresse de serveur IRC et qu'elle est dans votre liste des serveurs, il retourne l'info associée.

$serverip

Retourne l'adresse du serveur IP.

$show

Retourne $false si une commande est préfixée d'un . (point) pour la rendre silencieuse, autrement retourne $true.

$sreq

Retourne les réglages actuels /sreq dans le dialogue DCC Options send section.

$status

Retourne le statut de connexion du serveur.

Note : Cela retourne closing pendant l'évènement on DISCONNECT si la fenêtre statut en cours de fermeture est la cause de déconnexion.

$titlebar

Retourne le texte dans une barre de titre de mIRC, réglé par la commande /titlebar.

$url

Retourne l'URL actuellement active dans votre navigateur internet.

$url(N)

Retourne la Nième adresse dans votre liste URL.

Propriétés : desc, group

$url(0) retourne le nombre total d'items dans la liste URL
$url(2) retourne l'adresse du 2ème item dans la liste
$url(2).desc retourne la description du 2ème item dans la liste
$url(3).group retourne le groupe du 3ème item dans la liste

$usermode

Retourne votre mode utilisateur actuel sur le serveur IRC.

$version

Retourne la version de mIRC qui est utilisé.