Programmation mIRC/Identifieurs Texte et Numéro

Un livre de Wikilivres.

$abs(N)[modifier | modifier le wikicode]

Retourne la valeur absolue du nombre N.

$abs(5)

retourne 5

$abs(-1)

retourne 1

$and(A,B)[modifier | modifier le wikicode]

Retourne A ET binaire B.

$asc(C)[modifier | modifier le wikicode]

Retourne la valeur ASCII du caractère C.

$asc(A)

retourne 65

$asc(*)

retourne 42

$base(N,inbase,outbase,zeropad,précision)[modifier | modifier le wikicode]

Convertit le nombre N de inbase à outbase. Les deux derniers paramètres sont optionnels..

$base(15,10,16)

retourne F

$base(1.5,10,16)

retourne 1.8

$base(2,10,16,3)

retourne 002

Note : inbase est le format du chiffre à convertir, et outbase est le format du chiffre convertit. Le format, ou base, indique le nombre de chiffres différents composant tous les nombres.

biton(A,N)[modifier | modifier le wikicode]

Retourne la valeur A avec le Nième bit mis à 1.

Note : le A est en base décimal et l'opération est effectuée sur une base binaire. De plus, l'incrémentation de N va selon l'ordre de croissance, c'est à dire, le premier chiffre est le chiffre binaire de droite, donc le LSB (Lower Bit) et plus le chiffre N augmente, plus on incrémente sur la gauche vers le MSB (Most bit). Il faut avoir fait de la logique binaire pour comprendre ce que ça veut dire.

Prenons le chiffre 5. En base binaire (effectué avec $base(5,10,2)), cela donne 0000 0101 (j'ai fait exprès de rajouté les 0 sur la gauche pour une meilleure visibilité). Quand on fait $biton(5,2) il retourne 7. En regardant le format binaire, 7 est 0000 0111. On voit ici que le 2ème bit a été mis à 1. Quand on fait $biton(5,4) il retourne 13. En regardant le format binaire, 13 est 0000 1101. On voit ici que le 4ème bit a été mis à 1.

$bitoff(A,N)[modifier | modifier le wikicode]

Retourne la valeur A avec le Nième bit mis à 0.

Note : le A est en base décimal et l'opération est effectuée sur une base binaire. De plus, l'incrémentation de N va selon l'ordre de croissance, c'est à dire, le premier chiffre est le chiffre binaire de droite, donc le LSB (Lower Bit) et plus le chiffre N augmente, plus on incrémente sur la gauche vers le MSB (Most bit). Il faut avoir fait de la logique binaire pour comprendre ce que ça veut dire.

Prenons le chiffre 5. En base binaire (effectué avec $base(5,10,2)), cela donne 0000 0101 (j'ai fait exprès de rajouté les 0 sur la gauche pour une meilleure visibilité). Quand on fait $bitoff(7,2) il retourne 5. En regardant le format binaire, 5 est 0000 0101. On voit ici que le 2ème bit a été mis à 0. Quand on fait $bitoff(13,4) il retourne 5. En regardant le format binaire, 5 est 0000 0101. On voit ici que le 4ème bit a été mis à 0.

$bytes(N,bkmgt3)[modifier | modifier le wikicode]

Retourne la taille du fichier en format anglais (la virgule au niveau des milliers)

Propriétés : suf

Les options bkmgt retournent le résultat en octets (b), kilo-octets (k), mégaoctets (m), giga-octets (g), téraoctets (t).

La propriété .suf ajoute les suffixes b, k, M, G, T au résultat.

L'option 3 retourne un résultat au format 3 digits.

$calc(opérations)[modifier | modifier le wikicode]

Retourne le résultat des opérations spécifiées.

$ceil(N)[modifier | modifier le wikicode]

Retourne N arrondi à la valeur entière supérieure.

$chr(N)[modifier | modifier le wikicode]

Retourne le caractère ASCII en nombre N.

$chr(65)

retourne A

$chr(42)

retourne *

$compress(fichier|&bvar, blN) $decompress(fichier|&bvar) Compresse le fichier spécifié ou la variable binaire. Le résultat est une donnée brute compressée.

Où b indique une variable binaire dans le premier paramètre, et lN met un niveau de compression compris entre 1 et 6 (par défaut 6). Retourne 1 pour succès, 0 pour échec.

$cos(N), $acos(N) Retourne le cosinus et l'arc-cosinus de N.

Propriétés : deg

$count(chaîne,sous-chaîne,sous-chaîne2,...,sous-chaîne) Retourne le nombre de fois que la sous-chaîne survient dans la chaîne.

$count(hello,el) retourne 1

$count(hello,l) retourne 2

$encode(%var | &binvar, mubt, N) $decode(%var | &binvar, mubt, N) Encode ou décode le texte en %vars ou &binvars en utilisant Uuencode ou Mime.

Le second paramètre se compose d'options où m = mime, u = uucode (défaut), b = &binvar, et t = texte (défaut).

La ligne finale encodée est constituée de jusqu'à 60 caractères groupés. Vous pouvez spécifier N si vous voulez que mIRC retourne le Nième groupe. N = 0 retourne le nombre total de groupes dans la ligne.

Si encodage/décodage d'un binvar, les identifieurs retournent le nombre actuel de caractères écrits dans la &binvar. Notez que l'encodage utilise 33% plus d'espace de stockage.

Les deux derniers paramètres sont optionnels, par défaut mis à uuencode, et N = 1.

$floor(N) Retourne N arrondi la valeur entière inférieure.

$int(N) Retourne la partie entière d'un nombre flottant sans arrondi.

$int(3.14159) retourne 3

$isbit(A,N)

Retourne 1 si le Nième bit dans le nombre A est à 1.

$islower(texte) Retourne $true si le texte a une casse minuscule.

$isupper(texte) Retourne $true si le texte a une casse majuscule.

$left(texte,N) Retourne les N caractères à partir de la gauche du texte.

$left(goodbye,4) retourne good

Si N est une valeur négative, il retourne tout sauf les N caractères de droite.

$len(texte)

Retourne la longueur du texte.

$len(#mIRC) retourne 5

$log(N) Retourne le logarithme naturel de N.

$longip(adresse) Convertit une adresse IP en une valeur longue et vice-versa.

$longip(158.152.50.239) retourne 2660774639 $longip(2660774639) retourne 158.152.50.239

$lower(texte) Retourne le texte en casse minuscule.

$lower(HELLO) retourne hello

$mid(texte,S,N)

Retourne N caractères commençant à la position S dans le texte.

$mid(othello,3,4) retourne hell

Si N est zéro, il retourne le nombre de caractères de S jusqu'à la fin de la ligne.

Vous pouvez également utiliser des nombres négatifs pour S ou N.

$not(A) Retourne la valeur non binaire de A.

$or(A,B) Retourne A OU binaire de B.

$ord(N) Ajoute st, nd, rd, th au nombre approprié du nombre N.

$pos(texte,chaîne,N) Retourne un nombre indiquant la position de la Nième occurrence de la chaîne dans le texte.

$pos(hello there,e,1) retourne 2 $pos(hello there,e,2) retourne 9 $pos(hello there,a,1) retourne $null

Si N est zéro, il retourne le nombre de fois que la chaîne apparaît dans le texte.

Note : Vous pouvez utiliser $poscs() pour une version sensible à la casse.

$r , $rand(v1,v2)

Cela fonctionne de deux façons. Si vous fournissez avec des nombres pour v1 et v2, il retourne un nombre aléatoire entre v1 et v2. Si vous fournissez des lettres, il retourne une lettre aléatoire entre les lettres v1 et v2.

$rand(a,z) retourne une lettre dans la gamme a,b,c,...,z $rand(A,Z) retourne une lettre dans la gamme A,B,C,...,Z $rand(0,N) retourne un nombre dans la gamme 0,1,2,...,N

$remove(chaîne,sous-chaîne,...) Retire toute occurrence de sous-chaîne dans la chaîne.

$remove(abcdefg,cd) retourne abefg

Vous pouvez également spécifier de multiples paramètres de soustraction dans la chaîne :

$remove(abcdefg,a,c,e,g) retourne bdf

Note : Vous pouvez utiliser $removecs() pour une version sensible à la casse.

$replace(chaîne,sous-chaîne,nouvellechaîne,...) Remplace toute occurrence de la sous-chaîne dans la chaîne par la nouvelle chaîne.

$replace(abcdefg,cd,xyz) retourne abxyzefg

Vous pouvez également spécifier de multiples paramètres de remplacement :

$replace(abcdefg,a,A,b,B,c,C,d,D) retourne ABCDefg

Note : Vous pouvez utiliser $replacecs() pour une version sensible à la casse.

$replacex(chaîne,sous-chaîne,nouvellechaîne,...) Remplace toute occurrence de la sous-chaîne par la nouvelle chaîne exceptée pour des remplacements qui ont déjà été fait.

Note : Vous pouvez utiliser $replacexcs() pour une version sensible à la casse.

$right(texte,N) Retourne les N caractères du texte à partir de la droite.

$right(othello,5) retourne hello

Si N est une valeur négative, il retourne tout sauf les N caractères.

$round(N,D) Retourne l'arrondi flottant spécifié au Dième digit décimal.

$round(3.14159,2) retourne 3.14

Le paramètre D est optionnel.

$sin(N), $asin(N) Retourne le sinus et l'arc sinus de N.

Propriétés : deg

$sqrt(N) Retourne la racine carrée de N.

$str(texte,N) Retourne le texte répété N fois.

$str(ho,3) retourne hohoho

$strip(texte,burcmo) Retourne le texte sans les codes gras (b), souligné (u), inversé (r), et contrôle (c).

Le paramètre burcmo est optionnel. S'il est utilisé, il retire seulement les types de caractères spécifiés.

Le m applique les réglages dans le dialogue Messages, et le o applique les réglages "only if numbers of codes exceed" (Seulement si le nombre de codes excèdent) dans le dialogue messages.

$stripped Retourne le nombre de codes de contrôle qui ont été retirés d'un message arrivant, s'il y en a. Cela peut être utilisé dans tout événement de script lorsqu'un message est reçu d'un utilisateur.

$tan(N), $atan(N) Retournent la tangente et l'arc tangente de N.

Propriétés : deg

$upper(texte) Retourne le texte en lettre majuscule.

$upper(hello) retourne HELLO

$wrap(texte, fonte, taille, largeur, [mot,] N) Retourne la Nième ligne dans le texte découpé à la largeur spécifiée en pixels.

Si l'optionnel paramètre mot est 1, le texte est découpé en mots entiers (lequel est par défaut).

Vous pouvez spécifier 0 pour N pour retourner le nombre total de lignes découpées.

$xor(A,B) Retourne A XOR binaire de B.