# Programmation mIRC/Identifieurs Fichiers et Dossiers
## $abook(pseudo,N)

Retourne l'information au sujet de pseudonymes listés dans le carnet d'adresses.
Propriétés :
* nick : retourne le nom du pseudonyme du carnet d'adresses
* info : retourne les informations dans la case info du carnet d'adresses
* email : retourne les informations dans la case email du carnet d'adresses
* website : retourne les informations dans la case website du carnet d'adresses
* picture : retourne les informations dans la case picture du carnet d'adresses
* noteN : retourne les informations dans la case Note du carnet d'adresses. N est le numéro de ligne à renvoyer. Si N est nul, alors il indique le nombre de lignes dans la case Note.
Formats permis : $abook(pseudo) $abook(N) $abook(pseudo,N) où le pseudo peut également être un joker.

## $alias(N/nomdefichier)

Retourne le nom de fichier du Nième fichier alias chargé. Si vous spécifiez un nom de fichier, il retourne $null si le fichier n'est pas chargé.
* $alias(0) : retourne le nombre d'alias chargé
* $alias(2) : retourne le nom de fichier du 2ème fichier alias chargé
* $alias(moo.txt) : retourne $null si le fichier n'est pas chargé ou moo.txt s'il existe.

## $crc(texte|&binvar|nomdefichier,[N])

Retourne le checksum CRC d'un item spécifié, où :
* pour un texte normal : {{{2}}}
* pour &binvar : {{{2}}}
* pour un nom de fichier (par défaut) : {{{2}}}

## $disk(chemin|N)

Retourne l'information au sujet du disque dur spécifié, où N = 0 pour le nombre total de disques disponibles, et N > 0 pour accéder à chaque disque.
Propriétés :
* type :
* free : retourne l'espace libre du disque visé
* label : retourne le nom donné du disque visé
* size : retourne la taille totale du disque visé
* unc : retourne le chemin pour un disque réseau
* path : retourne le chemin pour un disque local
retourne $true si le disque c: existe, $false autrement

## $exists(fichier/dossier)

Retourne $true si le fichier ou le dossier existe et $false sinon.
retourne $true ou $false.

## $file(nomdefichier)

Retourne l'information sur le fichier spécifié.
Propriétés : size, ctime, mtime, atime, shortfn, longfn, attr
* size : retourne la taille du fichier
* ctime : retourne l'heure de création
* mtime : retourne l'heure de dernière modification
* atime : retourne l'heure de dernier accès
* shortfn : retourne le chemin complet du fichier au format DOS (taille des dossiers et fichier en 8.3)
* longfn : retourne le chemin complet du fichier au format 32 bits
* attr : retourne les attributs du fichier

## $filtered

Retourne le nombre de lignes qui ont été filtrées lors de l'utilisation de la commande /filter.

## $finddir(dossier,joker,N,profondeur,@window | commande)

Recherche le dossier spécifié et ses sous-dossiers pour le Nième nom de dossier correspondant à la spécification joker et retourne le chemin complet s'il est trouvé.
Propriété :
* shortfn : retourne le chemin complet du fichier au format DOS (taille des dossiers et fichier en 8.3)
$finddir(c:\,mirc*,1) retourne le premier nom de dossier correspondant à "mirc"
Si vous spécifiez une fenêtre personnalisée (@window) (avec une liste) au lieu du paramètre N, mIRC remplira la liste de la fenêtre personnalisée des résultats.
Si vous spécifiez une commande, la commande est accomplie sur chaque dossier qui est trouvé. Vous pouvez utiliser $1- pour référer le nom du dossier par exemple.
Si vous spécifiez une profondeur, mIRC cherchera uniquement N profondeurs de dossiers correspondant aux noms de fichier.

## $findfile(dossier,joker,N,profondeur,@window | commande)

Recherche le dossier spécifié et ses sous-dossiers pour le Nième nom de fichier correspondant à la spécification du fichier joker et retourne le chemin complet et le nom du fichier s'il est trouvé.
Propriété :
* shortfn : retourne le chemin complet du fichier au format DOS (taille des dossiers et fichier en 8.3)
$findfile(c:\mirc,*.exe,1) retourne c:\mirc\mirc.exe
Si vous spécifiez une fenêtre personnalisée (@window) (avec une liste) au lieu du paramètre N, mIRC remplira la liste de la fenêtre personnalisée des résultats.
Si vous spécifiez une commande, la commande est accomplie sur chaque dossier qui est trouvé. Vous pouvez utiliser $1- pour référer le nom du dossier par exemple.
Si vous spécifiez une profondeur, mIRC cherchera uniquement N profondeurs de dossiers correspondant aux noms de fichier.

## $getdir

Retourne le dossier du DCC Get spécifié dans le dialogue Options DCC.
$getdir(filespec) Retourne le dossier DCC pour le type de fichier spécifié.
$getdir(*.txt) retourne c:\mirc\text\ (par exemple)

## $ini(fichier,sujet/N,item/N)

Retourne le nom/Nième position du sujet/item spécifié dans un fichier texte/ini.
* $ini(mirc.ini,0) : retourne le nombre total de sujets dans mirc.ini
* $ini(mirc.ini,1) : retourne le nom du 1er sujet dans mirc.ini
* $ini(mirc.ini,help) : retourne la Nième position du sujet help s'il existe, ou retourne 0 s'il n'existe pas
Le paramètre item/N est optionnel. Si vous spécifiez N = 0, il retourne le nombre total de sujets/items.

## $isdir(nom de dossier)

Retourne $true si le dossier spécifique existe, $false autrement.

## $isfile(nom de fichier)

Retourne $true si le fichier spécifié existe, $false autrement.

## $lines(nom de fichier)

Retourne le nombre total de lignes dans le fichier texte spécifié.
retourne le nombre total de lignes dans c:\irc\kicks.txt

## $logdir

Retourne le dossier des logs comme spécifié dans la section Logging du dialogue Options.

## $longfn(nom de fichier)

Retourne la version longue d'un nom de fichier court.

## $mididir

Retourne le dossier midi spécifié dans la section Sound Requests du dialogue Options.

## $mircdir

Retourne le dossier actuel du programme mIRC.

## $mircexe

Retourne le chemin complet et nom de fichier du fichier mirc exe.

## $mircini

Retourne le nom du fichier ini principal, normalement mirc.ini.

## $mklogfn(nom de fichier)

Retourne le nom de fichier qui utilise le logging. Ajouter la date au nom de fichier si vous avez activé l'option dated logfiles dans le dialogue logging.
Vous pouvez également utiliser $mknickfn(pseudonyme) pour fixer le pseudonyme comme nom de fichier, et $mkfn(nom de fichier), lequel enlève les caractères invalides.

## $msfile(dossier,titre,texte OK)

Affiche le dialogue sélectionner le fichier et retourne N, le nombre de fichiers sélectionnés. $msfile(N) retourne chaque fichier. S'il y a trop de fichiers sélectionnés, $msfile retourne -1. Le titre et le texte OK sont optionnels.

## $nofile(nom de fichier)

Retourne le chemin du nom de fichier sans le nom de fichier actuel.

## $nopath(nom de fichier)

Retourne le nom de fichier sans le chemin s'il en a un.
retourne mirc.exe

## $read(nom de fichier, [ntswrp], [texte correspondant], [N])

Retourne une seule ligne de texte d'un fichier.
Cet identifieur fonctionne en conjonction de la commande /write.
Lit aléatoirement une ligne du fichier funny.txt. Programmation mIRC/Identifieurs Fichiers et Dossiers//echo $read(funny.txt, 24) Lit la ligne 24 du fichier funny.txt.
Lit une ligne de kick aléatoire du fichier kicks.txt et l'utilise dans la commande kick.
Scanne le fichier info.txt pour une ligne commençant par le mot mirc et retourne le texte suivant la valeur correspondante.
Scanne le fichier help.txt pour une ligne correspondant au texte joker *help*.
* r : implique une correspondance regex.
Si vous spécifiez les paramètres s, w ou r, vous pouvez également spécifier la valeur N pour spécifier la ligne que vous souhaitez commencer la recherche dans le fichier, par exemple :
* n : est spécifié alors la ligne lue ne sera pas évaluée et sera traitée comme un texte normal.
* p : les séparateurs de commande ($chr(124) ou ALTGR+6) sont traités en tant que tel au lieu d'un texte normal.
Si la première ligne dans le fichier est un nombre, il doit représenter le nombre total de lignes dans le fichier. Si vous spécifiez N = 0, mIRC retourne la valeur de la première ligne si c'est un nombre.
* t : mIRC traitera la première ligne dans le fichier comme du texte, même si c'est un nombre.

## $readn

Retourne le numéro de ligne qui a été utilisé dans un précédent appel de $read. Si aucune correspondance n'est trouvée, $readn est mise à zéro.

## $readini(nom de fichier, [np], section, item)

Retourne une seule ligne de texte d'un fichier ini
Cet identifieur fonctionne en conjonction de la commande /writeini.
Lit votre pseudonyme dans le fichier mirc.ini.
Si le paramètre n est spécifié alors la ligne est lue sans être évaluée et sera traitée comme du texte.
Si le paramètre p est spécifié, les séparateurs de commande | ($chr(124) ou ALTGR+6) sont traités en tant que tel au lieu d'un texte normal.

## $sdir(dossier,titre)

Affiche le dialogue de sélection de dossiers et retourne le dossier sélectionné. Le titre est optionnel.

## $sfile(dossier,titre,texte OK)

Affiche le dialogue de sélection de fichier et retourne le nom de fichier sélectionné. Le titre et le texte OK sont optionnels.

## $shortfn(nom de fichier)

Retourne la version raccourcie d'un nom long de fichier.