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...]

 

attrlistAttributs de sélection (voir les commutateurs d'attributs pour plus de détails)
orderListe hiérarchique de clés de tri
rangesUne ou plusieurs plages de dates, de descriptions, d'exclusions, de tailles, de durées
fileUn ou plusieurs fichiers à lister
tCode de sélection du type d'horodatage

 

/A:

Sélection d'attributs

/M

afficher le pied de page

/B

Noms de fichiers nus

/N

Désactiver les options

/CD:...

Chaîne COLORDIR

/O

Commande

/D

coloriser

/P

Pause page

/H

ne pas masquer . et .

/Q

Nom du propriétaire

/HL

Liaisons difficiles

/S

Sous-répertoires

/I"texte "

plage de description

/T[:t]

Type d'horodatage

/K

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 :

 

aAttributs

 

cCompression : 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)
dday (2 chiffres, zéro en tête)
mmois (2 chiffres, zéro en tête)
yannée (4 chiffres)

 

f[...]Nom du fichier ou du répertoire (sensible à la casse)
PChemin SFN
pChemin LFN
NNom du fichier SFN
nNom du fichier LFN (par défaut)
qMettre le nom de fichier entre guillemets s'il contient des espaces ou des caractères spéciaux.

 

iDescription

 

kValeur de hachage CKSUM(voir la  fonction @CKSUM )

 

mValeur de hachage MD5 ( voir la fonction @MD5 )

 

qPropriétaire du fichier ou du répertoire (NTFS uniquement)

 

rValeur de hachage CRC32 ( voir la fonction @CRC32 )

 

snoms de flux (NTFS uniquement)

 

spnoms 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)
hheures (2 chiffres, zéro en tête)
mminutes (2 chiffres, zéro en tête)
ssecondes (2 chiffres, zéro en tête)
dmillisecondes (séparateur décimal et 3 chiffres)
z[...]Taille
aTaille 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.
cLa 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_dirsLe nombre de répertoires créés
%_pdir_filesLe nombre de fichiers déplacés
%_pdir_errorsLe 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 les noms de répertoires avec un \n- \n- \n- \ndefin .

 

/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.

 

/BSupprime les lignes d'en-tête et de résumé, et afficheuniquement lesnoms de fichiers ou de sous-répertoires dans une seule colonne. Cette option est particulièrement utile lorsque vous souhaitez rediriger une liste de noms vers un fichier ou un autre programme. Si vous utilisez /B avec /S, PDIR affichera le chemin complet de chaque fichier au lieu de simplement son nom et son extension. Si vous utilisez/B avec /X sur un lecteur LFN, PDIR affichera le nom court de chaque fichier au lieu du nom long. /B définit également /H.

 

/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.

 

/DNe pas coloriser la liste des répertoires. Voir DIR pour plus d'informations sur la colorisation des répertoires.

 

/HAffiche les noms de répertoires"." et "..." (normalement supprimés).

 

/HLAffiche les liens en dur.

 

/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.

 

/KAffiche l'en-tête (nom du disque et du répertoire).

 

/MAffiche le pied de page (totaux du nombre de fichiers et d'octets) .

 

/NDésactive les options spécifiées.

 

dIgnorer les répertoires cachés (utilisé avec /S)
eNe pas afficher les erreurs
fSupprime les octets libres dans le pied de page
hSupprimer l'en-tête
jSauter les jonctions (utilisé avec /S)
lNe pas afficher le nom du lien pour les liens symboliques
m:nAfficher un maximum de nentrées de répertoire
sSupprimer le pied de page
vSupprime l'étiquette de volume dans l'en-tête
zIgnorer les répertoires système (lorsqu'il est utilisé avec /S)

 

/O...L'ordre de tri est appliqué aux listes de chaque sous-répertoire séparément. Il est possible d'utiliser n'importe quelle combinaison d'options de tri. Si plusieurs options sont spécifiées, la liste sera triée avec la première option de tri comme clé principale, la suivante comme clé secondaire, et ainsi de suite.

 

nTrier 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.
aTrier 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.
cTrier par taux de compression (le fichier le moins compressé de la liste sera affiché en premier).
dTri par date et heure (le plus ancien en premier) ; voir aussi /T:acw
eTrier par extension
gGrouper d'abord les sous-répertoires, puis les fichiers
iClasser par description de fichier (ignoré si /C ou /O:c est également utilisé).
oTrier par propriétaire
rInverser l'ordre de tri pour toutes les options
sTri par taille
tIdentique à d
uNon trié
xCombiné à /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.

 

/QAfficher le propriétaire du fichier.

 

/SAffiche 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:

 

aDate et heure du dernier accès (volumes NTFS).
cDate et heure de création.
wDate 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.