DIR |
Répertoire |
|---|---|
| MSX-DOS 1 | |
Syntaxe
| DIR /W /P Device:Filename | Version 1 |
| DIR /S /H /W /P /2 Device:\Path\ItemName + Device:\Path\ItemName.... | Version 2 |
Paramètres
| Nom | Description |
|---|---|
| Device | Ce paramètre permet d'indiquer le nom du périphérique utilisé. Il ne peut s'agir que d'un unité de disque. Si vous ne spécifiez pas l'unité de disque, l'ordinateur affichera les noms des fichiers sur l'unité de disque actuellement actif (par défaut, c'est l'unité de disque A:) |
| Path | Ce paramètre permet d'indiquer l'emplacement dans les dossiers du fichier ou du dossier à afficher. Chaque nom de dossier dans le chemin est séparé par une barre oblique inverse (\). Ce paramètre n'est disponible que sous MSX-DOS 2 / Nextor. |
| Filename | Ce paramètre permet d'indiquer le nom du fichier à afficher. Les caractères génériques peuvent remplacer certains caractères dans le nom du fichier pour obtenir plusieurs fichiers et/ou dossiers. L'astérisque (*) et le point d'interrogation (?) sont utilisés comme caractères génériques. L'astérisque correspond à n'importe quelle séquence de caractères, tandis que le point d'interrogation correspond à n'importe quel caractère unique. |
| ItemName | Ce paramètre sous MSX-DOS 2 / Nextor peut être un nom de fichier, mais aussi un nom de dossier dont vous souhaitez afficher tous les fichiers. |
| /S | Ce paramètre permet l'affichage des fichiers système. Ce paramètre est disponible uniquement depuis COMMAND2.COM 2.40. |
| /H | Ce paramètre permet l'affichage de fichiers ou de dossiers cachés. Ce paramètre n'est disponible que sous MSX-DOS 2 / Nextor. |
| /W | Ce paramètre permet d'obtenir un affichage simplifié des fichiers avec plusieurs noms de fichiers en sortie par ligne. Les noms de dossier, les attributs de fichier, les dates et les heures ne sont pas affichés. Cependant, si vous utilisez COMMAND2.COM 2.41 ou supérieur, les dossiers seront affichés en minuscules. Le nombre de fichiers affichés par ligne avec le paramètre W est également ajusté en fonction de la largeur de l'écran. Si la largeur de l'affichage est inférieure à 13 caractères, les noms de fichiers passeront à la ligne suivante. L'affichage non-/W est conçu pour tenir dans un écran de 40 colonnes, mais si moins de colonnes sont disponibles, certains champs de la liste ne seront pas affichés, de sorte que l'affichage tiendra toujours sur une seule ligne. |
| /P | Ce paramètre permet d'autoriser une pause en fin d'écran lors de l'affichage des fichiers jusqu'à l'appui sur une touche. |
| /2 | Ce paramètre permet d'afficher deux noms de fichiers par ligne. Cet affichage est conçu pour tenir dans un écran de 80 colonnes, mais si moins de colonnes sont disponibles, certains champs de la liste ne seront pas affichés, de sorte que l'affichage tiendra toujours sur une seule ligne. Ce paramètre est disponible uniquement depuis COMMAND2.COM 2.40. |
Description
Cette commande permet d'afficher les noms des fichiers sur le disque avec des informations supplémentaires : taille de chaque fichier, date de chaque fichier, heure de chaque fichier, nombre total de fichiers, nombre d'octets libres sur le disque.
Entrée de ligne de commande
Le Device:Filename ou Device:\Path\ItemName spécifie quels fichiers doivent être affiché. Si l'option /H est donnée, les fichiers cachés seront également répertoriés.
Dans la commande DIR, contrairement à toutes les autres commandes, il est permis de ne pas donner le nom de fichier principal ou l'extension du nom de fichier, et les deux seront par défaut '*'. Ainsi, un nom de fichier 'FRED' équivaut à 'FRED.*' et un nom de fichier '*.COM' équivaut à '*.COM'. Notez que si le '.' à la fin d'un nom de fichier principal est donné, alors l'extension est également supposée avoir été donnée, de sorte que le nom de fichier 'FRED.' n'est pas équivalent à 'FRED.*', contrairement à l'exemple ci-dessus.
Il existe deux formats de liste. Si l'option /W est donnée, alors une large liste est affichée, avec plusieurs noms de fichiers en sortie par ligne. Les noms de sous-répertoires, les attributs de fichier et la date et l'heure de création de chaque fichier ne sont pas affichés.
Si l'option /W n'est pas donnée, alors les noms de fichiers sont affichés avec un nom de fichier par ligne, ainsi que les attributs, la taille du fichier et la date et l'heure auxquelles le fichier a été modifié pour la dernière fois. Les attributs sont affichés sous la forme d'un 'r' si le fichier est en lecture seulement et d'un 'h' si le fichier est caché (et que /H est donné). Si l'heure d'un fichier est zéro (c'est-à-dire que le fichier n'a pas d'heure associée), le champ d'heure ne sera pas affiché. Si la date d'un fichier est zéro, ni les champs de date ni d'heure ne seront imprimés. Les formats d'affichage des dates et heures peuvent être modifiés (voir les commandes DATE et TIME).
Ensuite, l'affichage non-/W est conçu pour tenir dans un écran de 40 colonnes, mais si moins de colonnes sont disponibles, certains champs de la liste ne seront pas affichés, de sorte que l'affichage tiendra toujours sur une seule ligne. Le nombre de fichiers par ligne affichés lorsque /W est spécifié est également ajusté en fonction de la largeur de l'écran. Cependant, si la largeur de l'affichage est inférieure à 13 caractères, dans les deux cas, les noms de fichiers passeront à la ligne suivante.
En haut de la liste des fichiers, le nom du volume du disque et le nom du répertoire répertorié sont affichés. En bas, le nombre de fichiers répertoriés, le nombre total d'octets dans les fichiers et la quantité d'espace disque restant sont affichés.
Lorsque le répertoire d'un sous-répertoire est affiché, les deux premiers éléments répertoriés seront toujours deux sous-répertoires spéciaux appelés '.' et '..' . Ceux-ci sont automatiquement créés lors de la création d'un nouveau répertoire, et ce sont eux qui autorisent les '.' et '..' à donner dans les noms de chemin pour signifier respectivement les répertoires courant et parent.
Lors de l'affichage d'un nombre d'octets, le nombre est tronqué et affiché comme le nombre de kilo-octets s'il y a un 1 Ko ou plus.
Si l'option /P est donnée, la sortie s'arrêtera en bas de l'écran jusqu'à ce qu'une touche soit enfoncée.
Exemples
Dans l'exemple suivant, tous les noms de fichiers et de répertoires du répertoire actuel de l'unité de disque actuel seront affichés :
| DIR |
Cela pourrait ressembler à ceci :
|
Volume in drive A: is MSX-DOS 2 Directory of A:\ MSXDOS2 SYS r 4096 86-06-19 2:45p COMMAND2 COM r 10496 86-06-19 2:46p UTILS <dir> 86-06-19 2:50p HELP <dir> 86-06-19 2:50p 14K in 2 files 222K free |
Le disque contient donc les deux fichiers système MSXDOS.SYS et COMMAND2.COM du MSX-DOS, étant en lecture seulement, et deux répertoires appelés UTILS et HELP.
Un format de répertoire "large" a été demandé pour le répertoire HELP sur l'unité de disque B:
| DIR B:\HELP /W |
Cela pourrait ressembler à ceci :
|
Volume in drive B: is MSX-DOS 2 Directory of B:\HELP BUFFERS .HLP ATTRIB .HLP ASSIGN .HLP ATDIR .HLP CHDIR .HLP CD .HLP SYNTAX .HLP ENV .HLP BATCH .HLP EDITING .HLP 25K in 10 files 222K free |
Cet exemple listera tous les fichiers du répertoire UTILS et tous les fichiers du répertoire HELP, et fera une pause à la fin de chaque écran plein :
| DIR UTILS + HELP /P |
Aucun nom de fichier principal n'a été donné, et la valeur par défaut est «*». Ainsi, cette commande est équivalente à la commande «DIR *.COM» :
| DIR .COM |
Aucune extension n'a été donnée, la valeur par défaut est «.*». Cette commande est donc équivalente à la commande «DIR COMMAND2.*» :
| DIR COMMAND2 |