PreviousNext
Help > Programmation avec LAUNCHER Office > Les commandes LNCCMD > Liste des commandes > Commande DIRLIST
Commande DIRLIST

Permet de consulter la liste des fichiers contenus dans un répertoire.

 

Syntaxe

 

CHGVAR

VAR(&CMD) VALUE('DIRLIST')

CHGVAR

VAR(&PARM1) VALUE('
[Pattern="Fichiers à lister"]
[ ;Path="Chemin vers le répertoire"]
[ ;First= True / False ]
[ ;Close= True / False ]
[ ;SubDir= True / False ]
[ ;Hidden= True / False ]
')

CHGVAR

VAR(&PARM2) VALUE(' ')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 +

&PARM2 &RESULT)

 

 

Paramètres

 

Paramètres

 

Parm1

ou

Parm2

Pattern= : Permet d’indiquer le radical des fichiers à lister.
Exemple : Pattern="*.doc"
Le mot clé « Pattern » peut aussi contenir le chemin complet vers le répertoire.
Exemple : Pattern =\\FileServer\Docs\*.doc

Path= : Indique le chemin vers le répertoire, si celui ci n’a pas été donné par le mot clé « Pattern ».
Exemple : Path="\\FileServer\Docs"; Pattern="*.doc"

First=True Indique que l’on veut démarrer le listage des fichiers au début du répertoire. Si First est faux, la commande retournera l'entrée suivante dans le répertoire.

Close=True Termine le parcours du répertoire.

SubDir=True Indique qu’on ne veut lister que les sous répertoires du répertoire indiqué, et non les fichiers.
Si « SubDir » est faux, seul les fichiers sont listés.

Hidden=True Indique que l’on veut inclure les fichiers cachés dans le listage.

 

RESULT

A chaque appel, un nom de fichier est retourné dans le paramètre &RESULT.
Si la liste des fichiers a été retournée en totalité, &RESULT est vide.

Chaque fichier est retourné selon la structure suivante :

         Positions 1 à 256 : Nom du fichier.

         Position 257 : ‘N’. La lettre ‘N’ est présente si une entrée est présente.

         Position 258 : ‘A’ Si le fichier a l’attribut ‘Archive’.

         Position 259 : ‘H’. Si le fichier est caché.

         Position 260 : ‘R’. Si le fichier est en lecture seule.

         Position 261 : ‘D’. Si l’entrée est un sous répertoire.

         Position 262 : ‘S’. Si c’est un fichier système.

 

Exemple

 

CHGVAR

VAR(&CMD) VALUE('DIRLIST')

CHGVAR

VAR(&PARM1) VALUE('Pattern="*.xls";Path="N:\DOCS"')

CHGVAR

VAR(&PARM2) VALUE('First=True')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 +

&PARM2 &RESULT)