Voir aussi : ATTRIB, DESCRIBE, PDIR, SELECT et SETDOS.

 

Sélection de fichiers

 

Prend en charge le dialogue de commande, les caractères génériques étendus , les plages, les noms de fichiers multiples et les listes d'inclusion.

 

Internet : Peut être utilisé avec les serveurs HTTP et FTP.

 

Utilisation :

 

DIR peut être utilisé pour afficher des informations sur les fichiers d'un ou de plusieurs répertoires (locaux ou distants), dans un large éventail de formats. Selon les options choisies, vous pouvez afficher le nom, les attributs et la taille du fichier, l'heure et la date de la dernière modification apportée au fichier, la description du fichier et le taux de compression du fichier. Vous pouvez également afficher les informations en 1, 2, 4 ou 5+ colonnes, trier les fichiers de différentes manières, utiliser la couleur pour distinguer les types de fichiers et faire une pause après chaque plein écran.

 

Sivous souhaitez produire une sortie personnalisée qui sera ensuite analysée par un autre programme ou un fichier batch, ou si vous avez besoin d'un affichage de répertoire à usage particulier, consultez la commande PDIR. DIR et PDIR sont apparentés, mais ils n'ont pas les mêmes commutateurs et ne sont pas destinés à produire des résultats identiques.

 

Les différents affichages de DIR sont contrôlés par des options ou des commutateurs. La meilleure façon d'apprendre à utiliser les nombreuses options disponibles avec la commande DIR est d'expérimenter. Vous saurez rapidement quelles options vous souhaitez utiliser régulièrement. Vous pouvez sélectionner ces options de manière permanente en utilisant la  commande ALIAS.

 

Par exemple, pour afficher tous les fichiers du répertoire actuel, sur 2 colonnes, triés verticalement (d'une colonne à l'autre), et avec une pause à la fin de chaque page :

 

dir /2/p/v

 

Pour définir ce format par défaut, en utilisant un alias :

 

alias dir=*dir /2/p/v

 

Lorsque vous utilisez DIR sur un lecteur LFN, vous devez mettre entre guillemets tous les noms de fichiers contenant des espaces blancs ou des caractères spéciaux.

 

DIR définit trois variables internes :

 

 

Les sections suivantes regroupent les fonctionnalités de DIR en plusieurs catégories. De nombreuses sections passent d'une discussion générale à des informations plus techniques. Si certaines informations d'une catégorie sont trop détaillées pour vos besoins, n'hésitez pas à passer au début de la section suivante. Les sections sont les suivantes

 

       Sélection des fichiers

       Format de sortie DIR par défaut

       Changement de format

       Affichage de plusieurs colonnes

       Répertoires à code couleur

       Sortie redirigée

       Autres notes

       Options

       Utilisation du protocole FTP

 

Sélection des fichiers

 

DIR peut afficher des informations sur un seul fichier ou sur plusieurs, dizaines, centaines ou milliers de fichiers à la fois. Pour afficher des informations sur un seul fichier, il suffit d'ajouter le nom du fichier à la ligne de commande DIR :

 

dir january.wks

 

La manière la plus simple d'afficher des informations sur plusieurs fichiers à la fois est d'utiliser des caractères génériques. DIR peut utiliser les caractères génériques normaux (* et ?) et les caractères génériques étendus. Par exemple, pour afficher tous les  fichiers.WKS dans le répertoire actuel :

 

dir *.wks

 

Pour afficher tous les fichiers .TXT dont le nom commence par A, B ou C:

 

dir [abc]*.txt

 

Si vous ne spécifiez pas de nom de fichier, DIR affiche par défaut * sur les lecteurs LFN et *.* sur les lecteurs qui ne prennent pas en charge les noms de fichiers longs. Cette valeur par défaut affiche tous les fichiers et sous-répertoires non cachés du répertoire actuel. Si vous spécifiez un nom de fichier pour un  lecteur autre qu'un lecteur LFN, qui comprend des caractères génériques, mais pas d'extension, DIR  lui ajoutera .* pour qu'il corresponde à toutes les extensions.

 

Si vous reliez deux ou plusieurs noms de fichiers par des espaces, DIR affichera tous les fichiers correspondant au premier nom, puis tous les fichiers correspondant au second nom. Vous pouvez utiliser un lecteur et un chemin différents pour chaque nom de fichier. Cet exemple répertorie tous les  fichiers.WKS, puis tous les  fichiers.WK1 dans le répertoire actuel:

 

dir *.wks *.wk1

 

Si vous utilisez une liste d'inclusion pour lier plusieurs noms de fichiers, DIR affichera les noms de fichiers correspondants dans une seule liste. Seul le premier nom de fichier d'une liste d'inclusion peut avoir un chemin d'accès ; les autres fichiers doivent se trouver dans le même chemin. Cet exemple affiche les mêmes fichiers que l'exemple précédent, mais les fichiers.WKS et .WK1 sont mélangés:

 

dir *.wks;*.wk1

 

Vous pouvez inclure des fichiers dans le répertoire actuel ou nommé, ainsi que dans tous ses sous-répertoires accessibles, en utilisant l' option /S. Cet exemple affiche tous les  fichiers.WKS et .WK1 du répertoire D:\DATA et de chacun de ses sous-répertoires:

 

dir /s d:\data\*.wks;*.wk1

 

Vous pouvez également sélectionner les fichiers en fonction de leurs attributs à l'aide de l' option /A. Par exemple, cette commande affiche les noms de tous les sous-répertoires du répertoire courant :

 

dir /a:d

 

Enfin, avec l' option /I, DIR peut sélectionner les fichiers à afficher en fonction de leur description (voir DESCRIBE pour plus d'informations sur la description des fichiers). DIR affichera un fichier si sa description correspond au texte qui suit l' option /I. La recherche n'est pas sensible à la casse. Vous pouvez utiliser des caractères génériques et des caractères génériques étendus dans le texte. Par exemple, pour afficher tout fichier décrit comme "fichier de test", vous pouvez utiliser cette commande :

 

dir /i"test file"

 

Si vous souhaitez afficher les fichiers qui contiennent les mots "fichier test" dans leur description, utilisez des caractères génériques étendus comme celui-ci :

 

dir /i"*test file*"

 

Pour afficher uniquement les fichiers qui n'ont pas de description, utilisez :

 

dir /I"[]"

 

En outre,vous pouvez utiliser des plages pour sélectionner ou exclure des ensembles spécifiques de fichiers . Par exemple, pour afficher tous les fichiers modifiés au cours de la dernière semaine, tous les fichiers à l'exception de ceux portant l'extension.BAK , et tous les fichiers d'une taille supérieure à 500 Ko:

 

dir /[d-7]

dir /[!*.bak]

dir /[s500K]

 

Vous pouvez combiner ces techniques de sélection de fichiers selon vos besoins.

 

Format de sortie par défaut de DIR

 

Le format de sortie de DIR varie en fonction du type de volume ou de lecteur sur lequel les fichiers sont stockés. Si le volume prend en charge les noms de fichiers longs, le format DIR par défaut contient 4 colonnes : la date de la dernière modification ou écriture du fichier, l'heure de la dernière écriture, la taille du fichier en octets et le nom du fichier. Le nom est affiché tel qu'il est stocké sur le disque, en majuscules, en minuscules ou en caractères mixtes. DIR fait passer les noms de fichiers d'une ligne à l'autre s'ils sont trop longs pour tenir dans la largeur de l'écran. Le format de sortie standard est le suivant :

 

Volume in drive C is unlabeled Serial number is 3aaf:c891

Directory of C:\release\version12\*

 

2018-08-30 0:39 <DIR> .

2018-08-30 0:39 <DIR> ..

2018-08-25 11:30 <DIR> tcmd

2018-08-25 23:07 4,801,840 tcmd.exe

 

(Voir Changement de format ci-dessous pour plus d'informations sur la modification du format standard des noms de fichiers longs afin de laisser de la place aux descriptions de fichiers).

 

Sur les volumes FAT qui ne prennent pas en charge les noms de fichiers longs, le format DIR par défaut contient 5 colonnes : le nom du fichier, la taille du fichier en octets, la date de la dernière écriture, l'heure de la dernière écriture et la description du fichier. Les noms de fichiers sont listés en minuscules, les noms de répertoires en majuscules :

 

Volume in drive C is C - BOOTUP Serial ...

Directory of C:\*

 

. <DIR> 8-24-18 12:17

.. <DIR> 8-24-18 12:17

TEST <DIR> 8-01-18 16:21

jpstree.idx 196967 8-28-18 17:57 JP fuzzy directory index

 

La sortie de DIR est normalement triée par nom, les répertoires étant listés en premier. Vous pouvez modifier l'ordre de tri avec l' option /O. Par exemple, ces deux commandes trient la sortie par date. La première commande affiche le fichier le plus ancien en premier ; la deuxième commande affiche le fichier le plus ancien en dernier :

 

dir /o:d

dir /o:-d

 

Lors de l'affichage des descriptions de fichiers, le DIR enroule les longues lignes pour les faire tenir à l'écran. Le DIR affiche un maximum de 40 caractères de texte dans chaque ligne d'une description (sauf si la largeur de votre écran permet un affichage plus large). Si vous désactivez l'habillage de la description avec l' option /R, la description est tronquée au bord droit de l'écran, et une flèche vers la droite est ajoutée à la fin de la ligne pour vous avertir de l'existence d'un texte de description supplémentaire.

 

La sortie par défaut de DIR est triée. Il affiche d'abord les noms de répertoire, avec "<DIR>" inséré à la place de la taille du fichier, puis les noms de fichier. DIR part du principe que les séquences de chiffres doivent être triées numériquement (par exemple, le fichier DRAW2 est listé avant DRAW03 parce que 2 est numériquement plus petit que 03), plutôt que strictement alphabétiquement (où DRAW2 viendrait en second parce que "2" suit "0" dans l'ordre alphanumérique). Vous pouvez modifier l'ordre de tri avec l' option /O. Lorsque DIR affiche les noms de fichiers dans un format multi-colonnes, il les trie horizontalement à moins que vous n'utilisiez l' option /V pour afficher une sortie triée verticalement.

 

L'affichage de DIR peut être modifié de nombreuses façons pour répondre à différents besoins. La plupart des sections suivantes décrivent les différentes façons de modifier le format de sortie de DIR.

 

Changement de format

 

Sur les volumes qui prennent en charge les noms de fichiers longs, vous pouvez forcer DIR à utiliser un format de type FAT (nom de fichier en premier, suivi des informations sur le fichier) avec l' option /Z. Si nécessaire, DIR /Z tronque les noms de fichiers longs sur les lecteurs LFN et ajoute uneflèche droite pour indiquer que le nom contient des caractères supplémentaires.

 

Le format de sortie standard du LFN n'offre pas suffisamment d'espace pour afficher les descriptions avec les noms de fichiers. Par conséquent, si vous souhaitez afficher les descriptions de fichiers dans le cadre de la liste DIR sur un volume qui prend en charge les noms de fichiers longs, vous devez utiliser l' option /Z.

 

Si vous utilisez l' option /X,DIR affichera les noms de fichiers courts alternatifs pour les fichiers dont les noms sont longs . Utilisée seule, l'option /X permet à DIR d'afficher les noms sur deux colonnes après la taille, l'heure et la date : une colonne pour les noms de fichiers alternatifs ou courts et l'autre pour les noms de fichiers longs. Si un fichier n'a pas de nom court ou alternatif différent du nom long, la première colonne est vide.

 

Sivous utilisez les options/X et /Z ensemble, DIR affichera les noms de fichiers courts ou alternatifs dans le format d'affichage de type FAT.

 

Si vous utilisez l' option /B, DIR n'affiche que les noms de fichiers et omet la taille du fichier, l'horodatage et la description de chaque fichier, par exemple:

 

[c:\] dir w* /b

WINDOWS

WINNT

WINALIAS

WINENV.BTM

.....

 

Il existe plusieurs façons de modifier l'affichage produit par l'option /B.  L'option /F est similaire à /B, mais elle affiche le chemin d'accès complet et le nom de chaque fichier, au lieu de son seul nom. Pour afficher les mêmes informations pour un répertoire et ses sous-répertoires, utilisez /B /S ou /F /S.Vous pouvez utiliser /B /X pour afficher le nom abrégé de chaque fichier, sans autre information.

 

Affichage de plusieurs colonnes

 

DIR dispose de trois options, /2, /4 et /W, qui permettent de créer des affichages à plusieurs colonnes.

 

L' option /2 crée un affichage sur deux colonnes. Sur les lecteurs prenant en charge les noms de fichiers longs, seul le nom de chaque fichier est affiché, les noms de répertoires étant placés entre crochets pour les distinguer des noms de fichiers. Sur les lecteurs qui ne prennent pas en charge les noms de fichiers longs, ou lorsque  l'option /Z ou /X est utilisée (voir ci-dessous), l'affichage comprend le nom court, la taille du fichier et l'horodatage de chaque fichier.

 

L' option /4 est similaire à /2, mais affiche les informations sur les répertoires en 4 colonnes. Sur les lecteurs qui ne prennent pas en charge les noms de fichiers longs, ou lorsque /Z ou /X est utilisé (voir ci-dessous), l'écran affiche le nom et la taille du fichier en kilo-octets (Ko) ou en méga-octets (Mo), avec "<D>" dans la colonne de la taille pour les répertoires.

 

L' option /W affiche les informations relatives aux répertoires sur 5 colonnes ou plus, en fonction de la largeur de votre écran. Chaque entrée d'un affichage DIR /W contient soit le nom d'un fichier, soit le nom d'un répertoire. Les noms de répertoires sont placés entre crochets pour les distinguer des noms de fichiers.

 

Si vous utilisez l'une de ces options sur un lecteur prenant en charge les noms de fichiers longs et que vous ne sélectionnez pas un autre format d'affichage avec /Z ou /X, le nombre réel de colonnes sera basé sur le nom le plus long à afficher et sur la largeur de votre écran, et peut être inférieur au nombre que vous avez demandé (par exemple, vous ne verrez que trois colonnes même si vous avez utilisé /4). Si le nom le plus long est trop long pour tenir sur une seule ligne, l'affichage sera réduit à une colonne, et chaque nom sera enveloppé, avec des lignes vierges "supplémentaires" ajoutées pour que chaque nom prenne le même nombre de lignes.

 

Sur les lecteurs LFN, vous pouvez utiliser /Z avec l'une des options multi-colonnes pour créer un affichage au format FAT, avec les noms longs tronqués pour tenir dans l'espace disponible. Si vous utilisez /X, l'affichage au format FAT est également utilisé, mais les noms courts sont affichés (au lieu des noms longs tronqués). Le tableau suivant résume les effets des différentes options lors de l'utilisation de TCC sur un lecteur LFN :

 

 

 

Répertoires à code couleur

 

DIR peut afficher chaque nom de fichier et les informations associées dans une couleur différente, en fonction de l'extension, des attributs ou de la plage de correspondance du fichier.

 

Pour choisir les couleurs d'affichage, vous devez soit utiliser la  commande SET pour créer une variable d'environnement appelée COLORDIR, soit utiliser l' option de configuration Directory Colors. Si vous n'utilisez ni la variable ni l'option de configuration, DIR utilisera les couleurs d'écran par défaut pour tous les fichiers.

 

Si vous utilisez la variable COLORDIR, elle remplacera l' option Couleurs du répertoire. Il peut être utile d'utiliser la variable COLORDIR pour expérimenter, puis de définir des couleurs de répertoire permanentes à l'aide de l' option Couleurs du répertoire.

 

Leformat de la variable d'environnement COLORDIR et de l' option Couleurs du répertoire est le suivant :

 

ext ... :ColorName; ...

 

où "ext" est soit une extension de fichier (qui peut inclure des caractères génériques), soit un ou plusieurs des types de fichiers suivants :

 

 

ou une plage (taille, date, heure, description, propriétaire et/ou exclusion), ou un type de sous-système de fichiers:

 

 

et "ColorName" est un nom de couleur valide (voir Couleurs et noms de couleurs pour des informations sur les noms de couleurs). La spécification d'un type de sous-système ralentira considérablement l'affichage du répertoire, car TCC doit lire l'en-tête de chaque fichier pour trouver une correspondance.

 

Notez que si un fichier utilise l'un des noms de types de fichiers réservés indiqués ci-dessus comme extension (par exemple xyz.hidden), ce fichier recevra la couleur définie pour le type de fichier .

 

Contrairement à la plupart des spécifications de couleur, la partie "arrière-plan" du nom de la couleur peut être omise pour les couleurs de répertoire. Si vous ne spécifiez pas de couleur d'arrière-plan, DIR utilisera la couleur d'arrière-plan de l'écran actuel.

 

Par exemple, pour afficher les fichiers .COM et .EXE en rouge sur le fond d'écran actuel, les fichiers.C et .ASM en cyan vif sur le fond d'écran actuel, les fichiers en lecture seule en vert sur fond blanc et tous les autres dans la couleur par défaut:

 

set colordir=exe:red; c asm:bright cyan; rdonly:green on white

 

Pour afficher les applications de console 32 bits en vert vif et les applications de console 64 bits en rouge vif :

 

set colordir=EXETYPE_WIN32CUI:bri green;EXETYPE_WIN64CUI:bri red

 

Des caractères génériques étendus peuvent être utilisés dans les spécifications de couleur des répertoires . Par exemple, pour afficher les  fichiers.BAK, .BAX et .BAC en rouge, et tout le reste dans la couleur par défaut:

 

set colordir=BA[KXC]:red

 

Vous pouvez combiner des tests d'attributs avec les caractères génériques.and. / .or. / .xor. / .not. Par exemple, pour afficher en bleu les répertoires qui sont également cachés :

 

set colordir=dirs .and. hidden:blue

 

COLORDIR traite la ligne de gauche à droite et ne prend pas en charge les parenthèses.

 

Sortie redirigée

 

La sortie de la commande DIR, comme celle de la plupart des autres commandes internes, peut être redirigée vers un fichier, une imprimante, un port série ou un autre périphérique. Cependant, vous devrez peut-être prendre en compte certaines options de DIR lorsque vous redirigerez la sortie de DIR.

 

DIR adapte les noms de fichiers longs et les descriptions de fichiers à la largeur de l'écran. Sa sortie redirigée sera également adaptée à la largeur de l'écran. Utilisez l' option /R si vous souhaitez désactiver l'habillage des longues descriptions.

 

Si vous redirigez un répertoire codé en couleur vers un fichier ou un périphérique à caractères, DIR supprimera les données de couleur lorsqu'il enverra les informations du répertoire vers un fichier.

 

Pour rediriger la sortie de DIR vers le presse-papiers, utilisez CLIP : (ou CLIP0 : - CLIP9 :) comme nom de périphérique de sortie, par exemple :

 

dir *.exe > clip:

 

Utilisation FTP

 

Vous pouvez afficher des répertoires sur des serveurs FTP. Vous pouvez afficher des répertoires sur des serveurs FTP, par exemple :

 

dir ftp://ftp.microsoft.com/

 

Vous pouvez également utiliser la  commandeIFTP pour lancer une session FTP sur un serveur, puis utiliser une syntaxe simplifiée pour spécifier les fichiers et les répertoires souhaités.

 

Utilisation de HTTP

 

DIR a un support limité pour les noms de fichiers HTTP et HTTPS. DIR affiche le nom du fichier, sa taille et la date et l'heure (pour la dernière écriture uniquement). Les caractères génériques ne sont pas pris en charge (il s'agit d'une limitation de HTTP, et non de TCC).

 

Autres remarques

 

Si vous avez sélectionné un code de pays spécifique pour votre système, DIR affichera la date dans le format de ce pays. Le format de date par défaut est celui des États-Unis (mm-jj-aa). Le caractère séparateur dans l'heure du fichier sera également affecté par le code du pays. Lesséparateurs de milliers et de décimales dans les affichages numériques sont affectés par le code du pays et par les paramètres ThousandsChar et DecimalChar sélectionnés dans les boîtes de dialogue de configuration ou dans le fichier .INI.

 

DIR peut généralement afficher n'importe quelle date de fichier entre le 1er janvier 1980 et le 31 décembre 2099 si la date est fournie correctement par le système d'exploitation.

 

Si vous utilisez la compression de disque NTFS, vous pouvez utiliser le commutateur /C pour afficher le niveau de compression atteint pour chaque fichier. Dans ce cas, le taux de compression s'affiche à la place de la description du fichier. Vous pouvez également trier l'affichage par taux de compression à l'aide du  commutateur /O:c. Vous trouverez des informations détaillées sur ces deux options dans la section Options ci-dessous. Les options/C et /O:c sont ignorées pour les lecteurs non compressés. /C n'affichera pas les taux de compression sur les lecteurs prenant en charge les noms de fichiers longs, à moins que vous n'utilisiez également /Z pour passer à l'ancien format de nom de fichier court.

 

Si l'attribut OFFLINE est défini, DIR affichera la taille du fichier entre parenthèses (pour des raisons de compatibilité avec CMD).

 

Options :

 

Les options de la ligne de commande ne s'appliquent qu'aux noms de fichiers qui suivent l'option, et les options en fin de ligne ne s'appliquent qu'au nom de fichier précédent. Cela vous permet de spécifier différentes options pour différents groupes de fichiers, tout en conservant la compatibilité avec la commande DIR traditionnelle lorsqu'un seul nom de fichier est spécifié.

 

 

 

 

 

 

 

Lorsque / : est utilisé avec /B (Bare), le nom du fichier est affiché sur la première ligne, puis tous les flux, avec un retrait de deux espaces, sur les lignes suivantes:

 

c:\test\myfile.dat

xyz:$DATA

abc:$DATA

 

Lorsque / : est utilisé avec /F (Full path), le nom du fichier est affiché sur la première ligne, puis tous les flux sont ajoutés au nom du fichier sur les lignes suivantes :

 

c:\test\myfile.dat

c:\test\myfile.dat:xyz

c:\test\myfile.dat:abc

 

 

Vouspouvez spécifier /A:= pour afficher une boîte de dialogue qui vous aidera à définir des attributs individuels.

 

 

/B1 affiche les chemins d'accès relatifs lorsqu'il est utilisé avec /S. (Normalement, /B affiche le nom complet du fichier).

 

 

 

 

 

 

 

 

 

 

L' option /I peut être utilisée pour sélectionner des fichiers même si les descriptions ne sont pas affichées (par exemple, si /2 est utilisé). Cependant, l'option /I sera ignorée si  l'option /C ou /O:c est utilisée.

 

 

 

 

 

 

Un /N avec l'un des arguments suivants a une autre signification :

 

 

 

 

 

 

 

 

Si vous spécifiez un nombre après le /S, DIR limitera la récursivité des sous-répertoires à ce nombre. Par exemple, si vous avez une arborescence de répertoires "a", "b" et "c", /S2 n'affectera que les répertoires "a", "b" et "c".

 

Si vous spécifiez un + suivi d'un nombre après le /S, DIR n'affichera aucun nom de fichier jusqu'à ce qu'il atteigne cette profondeur dans l'arborescence des sous-répertoires . Par exemple, si vous avez une arborescence de répertoires \a\b\c\d\e, /S+2 n'affichera pas le contenu de \a ou \a\b.

 

 

 

Lesattributs définis sont représentés par leur lettre, les attributs non définis par le  caractère_ (trait de soulignement).

 

Si vous souhaitez ajouter une autre option après /T, vous devez commencer l'option suivante par une barre oblique. Si vous ne le faites pas, TCC interprétera le /T comme le  commutateur d'affichage de l'heure/T:{acw} (voir ci-dessous) et le caractère suivant comme un sélecteur d'heure. Par exemple :

 

dir /tz                incorrect, affichera une erreur

dir /t /z                correct

 

 

 

Si vous ajoutez un u après le champ, DIR affichera l'heure du fichier en UTC.