Commande interne. Fonctionne sur la ligne de commande ou dans un batch.

Affiche une liste de fichiers et de sous repertoires figurant dans le repertoire specifie. Lorsque vous utilisez la commande DIR sans parametre ou commutateur elle affiche un nom de repertoire ou un nom de fichier (avec l'extension) par ligne, la taille du fichier en octets ainsi que la date et l'heure de la derniere modification puis le nombre de fichiers, leur taille cumulee et l'espace disponible (en octets) sur le disque. Avec ou sans commutateurs, la commande DIR affiche en tete le nom de volume et le numero de serie du disque. Pour plus d'information sur le nom de volume et le numero de serie des disques, voyez la commande [LABEL]. Il est possible d'afficher l'arborescence du disque ou d'un repertoire dans le style Explorateur ou Winfile (le gestionnaire de fichiers de windows 3.x) avec la commande [TREE].

Syntaxe

DIR [lecteur:][chemin][fichier] [/P] [/W]

[/A[[:]attributs]][/O[[:]ordretri]] [/S] [/B] [/L] [/C]

Parametres

[lecteur:][chemin]

Precisent le lecteur et le repertoire dont vous voulez afficher le contenu.

[fichier]

Precise un fichier ou un groupe de fichiers a lister.

Commutateurs

/P Affiche la liste ecran par ecran. Pour afficher l'ecran suivant appuyez sur une touche.

/W Affiche la liste sur toute la largeur de l'ecran avec jusqu'a cinq noms de fichiers ou de repertoires sur chaque ligne.

/A[[:] attributs] Affiche uniquement les noms des repertoires et fichiers portant les attributs indiques. Sans ce parametre DIR affiche le nom de tous les fichiers a l'exception des fichiers systeme et caches. Si vous utilisez ce commutateur sans preciser d'attribut DIR affiche le nom de tous les fichiers y compris les fichiers systeme et caches. La liste suivante decrit les valeurs que vous pouvez utiliser comme attributs. Les deux points (:) sont facultatifs. Vous pouvez preciser plusieurs attributs parmi la liste ci-dessous (ne separez pas les valeurs par un espace).

H Fichiers caches

-H Fichiers non caches

S Fichiers systeme

-S Fichiers non systeme

D Repertoires

-D Fichiers uniquement (pas de repertoire)

A Fichiers prets a archiver (sauvegarde)

-A Fichiers non modifies depuis la derniere sauvegarde

R Fichiers en lecture seule

-R Fichiers autres qu'en lecture seule

/O[[:] ordretri] Indique l'ordre selon lequel DIR doit trier et afficher les noms de repertoire et de fichier. Si vous omettez ce commutateur DIR affiche les noms par ordre d'apparition dans le repertoire. Si vous utilisez ce commutateur sans preciser d'ordre de tri DIR affiche les noms de repertoire tries par ordre alphabetique puis les noms de fichier tries selon le meme ordre. Les deux points (:) sont facultatifs. La liste suivante decrit les valeurs que vous pouvez utiliser comme ordre de tri. Vous pouvez preciser plusieurs valeurs parmi la liste qui suit sans les separer par un espace.

N Par nom dans l'ordre alphabetique

-N Par nom dans l'ordre alphabetique inverse (de Z a A)

E Par extension dans l'ordre alphabetique

-E Par extension dans l'ordre alphabetique inverse (de Z a A)

D Par date et heure de la plus ancienne a la plus recente

-D Par date et heure de la plus recente a la plus ancienne

S Par taille dans l'ordre croissant

-S Par taille dans l'ordre decroissant

G Avec les repertoires groupes avant les fichiers

-G Avec les repertoires groupes apres les fichiers

C Par taux de compression du plus faible au plus eleve

-C Par taux de compression du plus eleve au plus faible

/S Affiche chaque occurrence du nom de fichier precise dans le repertoire specifie et dans tous ses sous-repertoires.

/B Liste les noms de repertoire et de fichier (avec leur extension) a raison d'un par ligne. Aucun en-tete ni resume n'est affiche. Le commutateur /B a priorite sur le commutateur /W.

/L Affiche les noms de repertoire et de fichier non tries et en minuscules. Ce commutateur ne convertit pas les caracteres etendus en minuscules.

/C[H] Affiche le taux de compression des fichiers compresses par DoubleSpace ou DriveSpace base sur des clusters de 8 Ko (et sur la taille des clusters du lecteur hote si vous precisez le commutateur optionnel H). Le commutateur /C[H] n'est pas pris en compte lorsqu'il est utilise avec le commutateur /W ou /B.

Utilisation de caracteres generiques avec la commande DIR

Vous pouvez utiliser les caracteres generiques (? et *) pour afficher la liste d'un sous ensemble de fichiers et de sous-repertoires. Le caractere generique "?" remplace un caractere et le caractere generique "*" remplace plusieurs caracteres.

Specification d'attributs de fichier

Si vous specifiez le commutateur /A avec plusieurs valeurs d'attribut DIR n'affiche que le nom des fichiers portant les attributs precises. Par exemple si vous specifiez le commutateur /A avec les valeurs d'attribut R et -H en utilisant soit /A:R-H soit /AR-H DIR n'affiche que le nom des fichiers avec l'attribut lecture seule qui ne sont pas caches.

Ordre de tri

Si vous precisez plusieurs valeurs dans ordretri DIR trie les fichiers en commencant par le premier critere puis selon le deuxieme critere et ainsi de suite. Si vous specifiez par exemple le commutateur /O avec les valeurs E et -S dans ordretri en utilisant /O:E-S ou /OE-S DIR trie les noms de repertoire et de fichier par extension puis par taille decroissante et affiche le resultat. Lors d'un tri par extension par ordre alphabetique les noms de fichier sans extension apparaissent d'abord suivis des noms de repertoire et enfin des noms de fichier portant une extension.

Format de date et d'heure

Les formats de date et d'heure utilises par la commande DIR dependent des parametres du pays indique dans le fichier [CONFIG.SYS]. Si vous n'utilisez pas la commande [COUNTRY] les formats sont ceux utilises aux USA, a l'envers quoi!

Utilisation de symboles de redirection et de barres verticales

Lorsque vous utilisez un symbole de redirection (>) pour rediriger la sortie de la commande DIR vers un fichier ou une barre verticale (|) pour envoyer la sortie de DIR vers une autre commande utilisez les commutateurs /A:-D et /B pour n'afficher que les noms de fichier. Vous pouvez utiliser le parametre fichier avec les commutateurs /B et /S pour preciser que DIR doit rechercher tous les noms de fichier correspondant a fichier dans le repertoire en cours et ses sous-repertoires. La commande DIR ne liste que la lettre du lecteur le nom du repertoire le nom du fichier et l'extension du nom du fichier un chemin par ligne pour chaque nom retrouve. Avant d'utiliser une barre verticale pour la redirection vous devez utiliser la variable d'environnement [TEMP] dans votre fichier [AUTOEXEC.BAT]. Dans le cas contraire le fichier temporaire apparaitra dans le repertoire liste.

Predefinition des parametres et commutateurs de la commande DIR

Vous avez la possibilite de predefinir les parametres et commutateurs de la commande DIR en incluant la commande [SET] avec la variable d'environnement [DIRCMD] dans le fichier [AUTOEXEC.BAT]. Vous pouvez utiliser toute combinaison valide de parametres et de commutateurs avec la commande [SET] [DIRCMD] y compris l'emplacement et le nom du fichier. Par exemple pour utiliser la variable d'environnement [DIRCMD] pour etablir le format d'affichage multicolonnes (/W) par defaut incluez la commande suivante dans votre fichier [AUTOEXEC.BAT]: set dircmd=/w

Vous pouvez annuler un commutateur defini par la variable d'environnement [DIRCMD] pour une utilisation de DIR en placant ce meme commutateur dans la ligne de commande DIR precede du signe moins comme dans l'exemple suivant: dir /-w

Vous pouvez changer les parametres par defaut definis avec [DIRCMD] en tapant a la suite de l'invite la commande [SET] avec un nouveau parametre ou commutateur apres le signe egal (=). Les nouveaux parametres par defaut sont valables pour toutes les commandes DIR ulterieures jusqu'a ce que vous utilisiez a nouveau [SET] [DIRCMD] dans la ligne de commande ou jusqu'a ce que vous relanciez le DOS.

Pour effacer toutes les valeurs par defaut tapez: set dircmd=

Exemples

Supposons que vous vouliez afficher les noms de tous les fichiers et repertoires figurant dans un repertoire y compris les fichiers caches ou systeme. Pour specifier cet affichage tapez: dir /a

Supposons que vous vouliez que DIR liste un repertoire apres l'autre jusqu'a ce que la liste de chaque repertoire sur le disque du lecteur en cours soit affichee. Supposons aussi que vous vouliez que DIR mette la liste de chaque repertoire dans l'ordre alphabetique dans le format multicolonne et observe une pause apres chaque ecran. Pour specifier ce type d'affichage assurez-vous que le repertoire racine est le repertoire en cours puis tapez: dir /s /w / o /p

La commande DIR affiche le nom du repertoire racine les noms des sous repertoires du repertoire racine et les noms des fichiers figurant dans le repertoire racine (y compris les extensions). Elle affiche ensuite les noms des sous repertoires et les noms des fichiers de chaque sous repertoire present dans l'arborescence de repertoires.

Pour modifier l'exemple precedent de telle sorte que DIR affiche les noms de fichier et les extensions sans inclure les noms de repertoire tapez: dir /s /w /o /p /a-d

Pour imprimer une liste de repertoires tapez le symbole de redirection et [PRN] apres toute forme de la commande DIR comme indique dans l'exemple suivant: dir > prn

Lorsque vous specifiez [PRN] dans la ligne de commande de DIR la liste du repertoire est envoyee a l'imprimante connectee au port [LPT1]. Si l'imprimante est connectee a un autre port remplacez [PRN] par le nom de port approprie.

Vous pouvez egalement rediriger la sortie de la commande DIR vers un fichier en remplacant [PRN] par un nom de fichier. Un chemin est egalement accepte dans la ligne de commande. Par exemple pour rediriger la sortie de DIR vers le fichier DIR.DOC du repertoire RECUS tapez la commande suivante: dir > \recus\dir.doc

Si le fichier DIR.DOC n'existe pas le DOS le cree a moins que le repertoire RECUS n'existe pas non plus. Dans ce cas le DOS affiche le message: Erreur de creation de fichier

Pour afficher la liste de tous les fichiers portant l'extension .TXT dans tous les repertoires du lecteur C: tapez:

dir c:\*.txt /w /o /s /p

La commande DIR affiche dans l'ordre alphabetique sur plusieurs colonnes la liste des noms de fichiers correspondants dans chaque repertoire et marque une pause jusqu'a ce que vous appuyiez sur une touche.