Identifieurs de Fichier et Répertoire


$abook(nick,N)
Retourne l'information à propos des nicks listé dans le Livre d'Adresses.

Attributs: nick, info, email, website, picture, noteN

Les formats alloués: $abook(nick) $abook(N) $abook(nick,N) où nick peut être un joker (e. g. Pano*).

$alias(N/fichier)
Retourne le nom de fichier du Nième fichier alias chargé. Si vous spécifiez le nom de fichier, il retourne $null s'il n'est pas chargé.

$alias(0) retourne le nombre de fichiers alias chargés
$alias(2) retourne le nom du 2e fichier alias chargé
$alias(moo.txt) retourne $null si le fichier n'est pas chargé et moo.txt s'il l'est

$crc(text|&binvar|filename,[N])
Retourne le CRC du contenu de l'item spécifié, N = 0 pour du text, 1 pour &binvar et 2 pour un fichier (défaut).

$disk(path|N)
Retourne de l'information sur le disque dur spécifié, où N = 0 retourne le nombre total et N > 0 retourne de l'information sur le disque spécifié.

Attributs: type, free, label, size, unc

$disk(c:) retourne $true si le disk dur c: existe sinon $false.

L'attribut unc retourne le chemin d'un disque réseau.

$exists(fichier/répertoire)
Retourne $true si un fichier ou répertoire existe, sinon $false.

$exists(c:\mirc\mirc.exe) retourne $true ou $false.

$file(fichier)
Retourne de l'information sur le fichier spécifié.

Attributs: size, ctime, mtime, atime, short, long, attr

$file(mirc.exe).size retourne la taille du fichier
$file(mirc.exe).ctime retourne le temps de création
$file(mirc.exe).mtime retourne le temps de modification
$file(mirc.exe).atime retourne le temps du dernier accès

$filtered
Retourne le nombre de lignes qui ont été filtrés avec la commande /filter.

$finddir(dir,wildcard,N,profondeur,@window | command)
Recherche le répertoire spécifié est ses sous-répertoires pour le Nième répertoire qui correspond au wildcard et retourne le chemin complet et répertoire où il a été trouvé.

Attributs: shortfn

$finddir(c:\,mirc*,1) retourne le premier répertoire commençant par "mirc"

Si vous spécifiez un nom de fenêtre @window au lieu du paramètre N, mIRC va remplir la fenêtre @window avec les résultats.

Si vous spécifiez une commande, la commande est exécuté à chaque répertoire trouvé.

//echo 1 $finddir($mircdir,*.*,0,echo $1-)

Si vous spécifiez la profondeur, mIRC va chercher seulement N répertoires profond.

Note: Les paramètres @window/commande et profondeur sont optionnels.

$findfile(dir,wildcard,N,depth,@window | command)
Recherche dans le répertoire spécifiez et ses sous-répertoires pour le Nième nom de fichier correspondant avec le wilcard et retourne le chemin complet et le nom de fichier trouvé.

Attributs: shortfn

$findfile(c:\,mirc*.exe,1) retourne c:\mirc\mirc.exe

Si vous spécifiez un nom de fenêtre @window au lieu du paramètre N, mIRC va remplir la fenêtre @window avec les résultats.

Si vous spécifiez une commande, la commande est exécuté sur chaque nom de fichier trouvé.

//echo 1 $findfile($mircdir,*.*,0,echo $1-)

Si vous spécifiez la profondeur, mIRC va chercher seulement N répertoires profond.

Note: Les paramètres @window/commande et profondeur sont optionnels.

$getdir
Retourne le répertoire DCC spécifiez dans les options DCC.

$getdir(extension)
Retourne le répertoire DCC pour le type de fichier spécifié.

$getdir(\*.txt) retourne c:\mirc\text (par exemple)

$ini(fichier,topic/N,item/N)
Retourne le nom/Mième position du [sujet] spécifique dans un fichier ini/texte.

$ini(mirc.ini,0) retourne le nombre total de sujets du fichier mirc.ini
$ini(mirc.ini,1) retourne la 1ère section ini du fichier mirc.ini
$ini(mirc.ini,help) retourne la position N du sujet [help] ou 0 s'il n'existe pas

Le paramètre item/N est optionnel. si vous spécifiez N = 0, ceci retourn le nombre total d'items.

$isdir(répertoire)
Retourne $true si le nom est un nom de répertoire existant, sinon $false.

$isfile(fichier)
Retourne $true si le nom de fichier est un fichier, sinon $false.

$lines(fichier)
Retourne le nombre de lignes du fichier donné.

$lines(c:\irc\kicks.txt) retourne le nombre total de lignes du fichier c:\irc\kicks.txt.

$logdir
Retourne le répertoire des Logs comme spécifié dans le dialog Logging des options.

$longfn(fichier)
Retourne la version longue du nom de fichier, et ne fonctionne qu'en mIRC 32bit. En 16bit retourne le même fichier.

$mididir
Retourne le répertoire des sons midis spécifié dans la section Requêtes Sonores du dialog des Options.

$mircdir
Retourne le répertoire courant du programme mIRC.

$mircexe
Retourne le nom du fichier et le chemin complet du fichier exe de mIRC.

$mircini
Retourne le fichier .ini principale de mIRC, d'habitude mirc.ini.

$mklogfn(fichier)
Retourne le format de fichier utilisé dans le logging. Ajoute la date au nom de fichier si cette option est active dans les options Logging.

Vous pouvez utiliser $mknickfn(nick) pour fixer un nick en nom de fichier et $mkfn(fichier) qui enlève les caractères illégaux.

$msfile(dir,title,oktext)
Affiche le dialog de sélection de fichiers multiples et retourne N, le nombre de fichiers sélectionnés. $msfile(N) retourne chacun des fichiers. Si trop de fichiers ont été sélectionnés, $msfile() retourne -1. Title et oktext sont optionnels.

$nofile(fichier)
Retourne le chemin sans le nom du fichier.

$nopath(fichier)
Retourne le nom du fichier sans le chemin si chemin il y a.

$nopath(c:\mirc\mirc.exe) retourne mirc.exe.

$read(filename, [ntswr], [matchtext], [N])
Retourne une ligne unique de texte d'une fichier.

Cet identifieur fonctionne de pair avec la commande /write.

//echo $read(funny.txt)

Lit une ligne aléatoirement du fichier funny.txt.

//echo $read(funny.txt,24)

Lit la ligne 24 du fichier funny.txt.

//kick # $1 $read(kicks.txt)

Lit une ligne aléatoire du fichier kicks.txt et l'utilise dans la commande kick.

//echo $read(info.txt,s,mirc)

Scrute le fichier info.txt pour une ligne débuttant par le mot mirc.

//echo $read(help.txt,w,*help*)

Scrute le fichier help.txt pour une ligne correspondante au mot en joker *help*. L'option r implique une expression régulière.

Si vous spécifiez les options s, w ou r, vous pouvez aussi spécifier une valeur de N qui dicte le numéro de # où débutter la recherche dans le fichier, eg.:

//echo $read(versions.txt,w,*mirc*,100)

Si l'option n est spécifié, alors la ligne ne sera pas évaluée et sera traitée comme du texte.

Si la première ligne est une nombre, il doit représenter le nombre de lignes du fichier. Si vos spécifiez N = 0, mIRC retourne la valeur de la première ligne si c'est un nombre.

Si l'option t est spécifiée, alors mIRC traite la première ligne comme du texte, même si c'est un nombre.

$readn
Retourne le numéro de la ligne correspodante à l'appel précédent de $read(). Si aucune correspondance n'a été faite, alors $readn égale zéro.

$readini(filename, [n], section, item)
Retourne une ligne de texte unique d'un fichier ini.

Cet identifieur fonctionne avec la commande /writeini .

//echo $readini(mirc.ini,mIRC,nick)

Lit votre nickname du fichier mirc.ini.

Si l'option n est spécifié, alors la ligne ne sera pas évaluée et sera traitée comme du texte.

$sdir(dir,titre)
Affiche le dialog de sélection de répertoire et retourne le répertoire sélectionné. Le Titre est optionnel.

$sfile(dir,titre,textok)
Affiche le dialog de sélection de fichier et retourne le fichier sélectionné. Le titre et textok sont optionnels.

$shortfn(fichier)
Renvoie le nom du fichier dans sa version courte, ne fonctionne qu'en 32bits, en 16bits renvoie le même nom.