| Objet : | Afficher des informations sur les fichiers et les sous-répertoires dans deschamps définissables par l'utilisateur. Ils'agit d'une commande"DIR programmable". |
| Format : | PDIR [ranges] [/\ /A:[attrlist] /B CD:text /D /H /HL /I"text" /K /M /N[defhjlsvz] /O:[order] /P[n] /Q /S[[+]n] /T:t /(...)] [file...] |
| attrlist | Attributs de sélection (voir les commutateurs d'attributs pour plus de détails) |
| order | Liste hiérarchique de clés de tri |
| ranges | Une ou plusieurs plages de dates, de descriptions, d'exclusions, de tailles, de durées |
| file | Un ou plusieurs fichiers à lister |
| t | Code de sélection du type d'horodatage |
/A: |
Sélection d'attributs |
afficher le pied de page |
|
Noms de fichiers nus |
Désactiver les options |
||
/CD:... |
Chaîne COLORDIR |
Commande |
|
coloriser |
Pause page |
||
ne pas masquer . et . |
Nom du propriétaire |
||
Liaisons difficiles |
Sous-répertoires |
||
/I"texte " |
plage de description |
/T[:t] |
Type d'horodatage |
afficher l'en-tête |
champs et format de sortie |
Voir aussi : DIR, ATTRIB, DESCRIBE et SELECT.
Sélection de fichiers
Prend en charge les commutateurs d'attributs, 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 FTP/HTTP.
Utilisation
PDIR est une commande extrêmement flexible qui vous permet d'afficher des informations sur les fichiers et les répertoires d'un ou de plusieurs volumes ou répertoires locaux ou distants dans un large éventail de formats définis par l'utilisateur. Pour une version plus simple, voir la commandeDIR.
PDIR et DIR sont apparentés, mais ils n'ont pas les mêmes commutateurs et ne sont pas destinés à produire des résultats identiques. PDIR est principalement destiné à produire une sortie qui sera ensuite analysée par un autre programme (ou un fichier batch), ou (plus rarement) pour un affichage de répertoire à usage particulier. Ses options et sa sortie sont orientées vers ces applications.
Les différents affichages de PDIR sont contrôlés par des options ou des commutateurs. La meilleure façon d'apprendre à utiliser les nombreuses options disponibles avec la commande PDIR est d'expérimenter. Vous saurez rapidement quelles options vous souhaitez utiliser régulièrement. Vouspouvez alors sélectionner ces options de manière permanente à l'aide de la commande ALIAS.
L'option /(...) spécifie les champs à afficher et leur formatage. (Vous pouvez avoir plusieurs options /(...) sur une même ligne). La syntaxe est la suivante :
| a | Attributs |
| c | Compression : Affiche lepourcentage decompression sur les disques NTFS dont la compression est activée. |
| d[...] | Date (vous devez spécifier au moins un sous-champ, sinon le champ reste vide) |
| d | day (2 chiffres, zéro en tête) |
| m | mois (2 chiffres, zéro en tête) |
| y | année (4 chiffres) |
| f[...] | Nom du fichier ou du répertoire (sensible à la casse) |
| P | Chemin SFN |
| p | Chemin LFN |
| N | Nom du fichier SFN |
| n | Nom du fichier LFN (par défaut) |
| q | Mettre le nom de fichier entre guillemets s'il contient des espaces ou des caractères spéciaux. |
| i | Description |
| k | Valeur de hachage CKSUM(voir la fonction @CKSUM ) |
| m | Valeur de hachage MD5 ( voir la fonction @MD5 ) |
| q | Propriétaire du fichier ou du répertoire (NTFS uniquement) |
| r | Valeur de hachage CRC32 ( voir la fonction @CRC32 ) |
| s | noms de flux (NTFS uniquement) |
| sp | noms dechemin et de flux sous forme de nom de chemin+nom de fichier+nom de flux (NTFS uniquement) |
| t[...] | Heure (vous devez spécifier au moins un sous-champ, sinon le champ reste vide) |
| h | heures (2 chiffres, zéro en tête) |
| m | minutes (2 chiffres, zéro en tête) |
| s | secondes (2 chiffres, zéro en tête) |
| d | millisecondes (séparateur décimal et 3 chiffres) |
| z[...] | Taille |
| a | Taille allouée (elle est généralement supérieure à la taille physique, sauf si le fichier est compressé). Notez que vous ne pouvez pas obtenir la taille allouée sur les serveurs FTP ou les noms de domaine en réseau. |
| c | La taille sera formatée en utilisant le séparateur de milliers (la valeur par défaut est une virgule) |
| k|K|m|M|g|G|t|T | (sensible à la casse) en kilo-octets, méga-octets, giga-octets ou téra-octets, comme utilisé dans les fonctions variables (voir Taille de la mémoire / Espace disque / Unités de taille de fichier et Format de rapport). Notez que la taille sera tronquée et non arrondie. |
@function[*]
| appelle la fonction variable spécifiée (interne ou définie par l'utilisateur). Pour spécifier le nom du fichier en cours, utilisez * comme paramètre . Par exemple, pdir /(f @md5[*]) affiche le nom du fichier et le hachage MD5. Notez que le préfixe % du nom de la fonction n'est PAS utilisé avec le paramètre symbolique *. Si le paramètre de la fonction n'est pas le * symbolique ou s'il s'agit d'une fonction "interne", le préfixe% doit être doublé, par exemple, @function1[%%@function2[*]]. |
| "..." | Chaîne littérale (entre guillemets). Les caractères sont affichéstels quels sur , à l'exception des caractères d'échappement qui sont convertis. |
Vous pouvez également spécifier un format, indépendamment pour chaque champ, en faisant précéder le caractère du champ de sa spécification de format :
| [-]i.a |
où
- spécifie la justification à gauche au lieu de la justification à droite par défaut ;
i spécifie la largeur minimale du champ, et
a indique la largeur maximale du champ.
Si le premier chiffre de i est 0, le champ sera rempli de zéros au lieu d'espaces. Certains champs ne peuvent pas être réduits en dessous d'une largeur minimale (par exemple , le champz (taille) doit comporter au moins 15 chiffres).
Si une ligne PDIR est vide (par exemple, si vous avez un @IF intégré), elle ne sera pas affichée.
Si vous souhaitez ajouter des champs sans espace blanc intermédiaire ou avec un caractère de délimitation personnalisé, vous pouvez utiliser des guillemets doubles pour spécifier les arguments. Par exemple, pour afficher la date et l'heure sans espace entre elles :
pdir /(dymd""thms) *
Ou pour afficher la date et l'heure séparées par un + :
pdir /(dymd "+"thms) *
PDIR définit trois variables internes :
| %_pdir_dirs | Le nombre de répertoires créés |
| %_pdir_files | Le nombre de fichiers déplacés |
| %_pdir_errors | Le nombre d'erreurs. |
Exemple
Pour afficher le CRC, le LFN complet et le propriétaire de chaque fichier :
pdir /(r fpn q) *
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é .
Laplupart des options sont utilisées pour sélectionner les fichiers/répertoires souhaités . ( L'option spéciale /(...) est utilisée pour spécifier quelles caractéristiques des fichiers ou répertoires sélectionnés doivent être affichées, dans quel ordre et sous quel format.
| /A :... | Afficher uniquement les fichiers pour lesquels le ou les attributs spécifiés ont été définis. Voir Commutateurs d'attributs pour plus d'informations sur les attributs qui peuvent suivre /A :. |
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).
| /CD : | Définit une chaîne de coloration de répertoire personnalisée à utiliser à la place de la variable d'environnement COLORDIR ou de l'option ColorDir dans TCMD.INI. |
| /D | Ne pas coloriser la liste des répertoires. Voir DIR pour plus d'informations sur la colorisation des répertoires. |
| /I "text" | Sélectionne les noms de fichiers en fonction du texte contenu dans leur description. Pour plus de détails,reportez-vous à la rubrique Plages de description. |
| d | Ignorer les répertoires cachés (utilisé avec /S) |
| e | Ne pas afficher les erreurs |
| f | Supprime les octets libres dans le pied de page |
| h | Supprimer l'en-tête |
| j | Sauter les jonctions (utilisé avec /S) |
| l | Ne pas afficher le nom du lien pour les liens symboliques |
| m:n | Afficher un maximum de nentrées de répertoire |
| s | Supprimer le pied de page |
| v | Supprime l'étiquette de volume dans l'en-tête |
| z | Ignorer les répertoires système (lorsqu'il est utilisé avec /S) |
| n | Trier par nom de fichier et extension (par défaut). Si e est également spécifié, le tri se fait uniquement sur le nom. |
| - | Inverse l'ordre de tri pour l'option suivante. |
| a | Trier les noms et les extensions dans l'ordre ASCII standard, plutôt que de les trier numériquement lorsque des chiffres sont inclus dans le nom ou l'extension. |
| c | Trier par taux de compression (le fichier le moins compressé de la liste sera affiché en premier). |
| d | Tri par date et heure (le plus ancien en premier) ; voir aussi /T:acw |
| e | Trier par extension |
| g | Grouper d'abord les sous-répertoires, puis les fichiers |
| i | Classer par description de fichier (ignoré si /C ou /O:c est également utilisé). |
| o | Trier par propriétaire |
| r | Inverser l'ordre de tri pour toutes les options |
| s | Tri par taille |
| t | Identique à d |
| u | Non trié |
| x | Combiné à /S, trie les résultats de tous les répertoires et les affiche dans une seule liste. Notez que /O:x désactive les en-têtes et les pieds de page. |
| /P[n] | Attendez qu'une touche soit pressée après chaque page d'écran avant de poursuivre l'affichage . Lesoptions disponibles à l'invite sont expliquées en détail dans les rubriques Page et File Prompts. L'option /P a un argument optionnel n qui spécifie le nombre de secondes à attendre pour une touche avant de continuer. |
| /S | Affiche les informations sur les fichiers du répertoire actuel et de tous ses sous-répertoires accessibles . |
Si vous spécifiez un nombre après le /S, PDIR 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, PDIR 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.
| /T:type | Spécifie lequel des champs de date et d'heure ci-dessous, disponibles sur un lecteur prenant en charge les noms de fichiers longs, doit être affiché et utilisé pour le tri: |
| a | Date et heure du dernier accès (volumes NTFS). |
| c | Date et heure de création. |
| w | Date et heure de la dernière écriture (par défaut). |
Si /T n'est pas spécifié, la valeur par défaut est /T:w.
Si vous ajoutez un u après le champ, DIR affichera l'heure du fichier en UTC.
Remarque : si plusieurs types de temps sont spécifiés, le premier spécifié est utilisé, et tous les suivants sont ignorés.
| /(...) | Utilisez cette option pour définir les différents champs et formats d'affichage que vous souhaitez utiliser pour chaque entrée sélectionnée. Les champs peuvent être placés dans n'importe quel ordre et peuvent être répétés. Si cette option n'est pas utilisée, le format de sortie est identique à celui de la commande DIR. Si vous spécifiez plusieurs options/(...), PDIR insérera un espace dans la sortie entre chacune d'elles. |