4D v14.3

LISTE DES DOCUMENTS

Accueil

 
4D v14.3
LISTE DES DOCUMENTS

LISTE DES DOCUMENTS 


 

LISTE DES DOCUMENTS ( cheminAccès ; documents {; options} ) 
Paramètre Type   Description
cheminAccès  Chaîne in Chemin d'accès de volume ou de dossier
documents  Tableau texte in Nom des documents situés à cet endroit
options  Entier long in Options de construction de la liste

La commande LISTE DES DOCUMENTS remplit le tableau de type Texte documents avec les noms des documents situés à l'endroit que vous avez indiqué avec le paramètre cheminAccès.

Note : Vous devez passer un chemin d'accès absolu dans le paramètre cheminAccès.

Par défaut, si vous omettez le paramètre options, seuls les noms des documents sont retournés dans le tableau documents. Vous pouvez modifier ce fonctionnement en passant dans le paramètre options une ou plusieurs des constantes suivantes, placées dans le thème Documents système :

Constante Type Valeur Commentaire
Chemin absolu Entier long 2 Le tableau documents contient des chemins d’accès absolus
Chemin POSIX Entier long 4 Le tableau documents contient des chemins d’accès au format POSIX
Chemin récursif Entier long 1 Le tableau documents contient les fichiers et tous les sous-dossiers du dossier spécifié
Ignorer invisibles Entier long 8 Les documents invisibles ne sont pas listés

Notes :

  • Avec l’option Chemin récursif en mode relatif (option 1 seule), les chemins des documents situés dans des sous-dossiers débutent par les caractères ":" ou "\" en fonction de la plate-forme.
  • Avec l’option Chemin POSIX en mode relatif (option 4 seule), les chemins ne débutent pas par "/"
  • Avec l’option Chemin POSIX en mode absolu (option 4 + 2), les chemins débutent toujours par "/"

S'il n'y pas de document à l'endroit défini, la commande retourne un tableau vide. Si le chemin d'accès que vous avez passé dans cheminAccès est invalide, LISTE DES DOCUMENTS génère une erreur de gestionnaire de fichier que vous pouvez intercepter à l'aide d'une méthode installée par APPELER SUR ERREUR.

Liste de tous les documents dans un dossier (syntaxe par défaut) :

 LISTE DES DOCUMENTS("C:\\";tabFichiers)

-> tabFichiers :
        Texte1.txt
        Texte2.txt

Liste de tous les documents dans un dossier en mode absolu :

 LISTE DES DOCUMENTS("C:\\";tabFichiers; Chemin absolu)

-> tabFichiers :
        C:\Texte1.txt
        C:\Texte2.txt

Liste de tous les documents en mode récursif (relatif) :

 LISTE DES DOCUMENTS("C:\\";tabFichiers;Chemin récursif)

-> tabFichiers :
        Texte1.txt
        Texte2.txt
        \Dossier1\Texte3.txt
        \Dossier1\Texte4.txt
        \Dossier2\Texte5.txt
        \Dossier2\Dossier3\Image1.png

Liste de tous les documents en mode récursif absolu :

 LISTE DES DOCUMENTS("C:\\MonDossier\\";tabFichiers;Chemin récursif+Chemin absolu)

-> tabFichiers :
        C:\MonDossier\MonTexte1.txt
        C:\MonDossier\MonTexte2.txt
        C:\MonDossier\Dossier1\MonTexte3.txt
        C:\MonDossier\Dossier1\MonTexte4.txt
        C:\MonDossier\Dossier2\MonTexte5.txt
        C:\MonDossier\Dossier2\Dossier3\MonImage1.png

Liste de tous les documents en mode récursif POSIX (relatif) :

 LISTE DES DOCUMENTS("C:\\MonDossier\\";tabFichiers;Chemin récursif+Chemin POSIX)

-> tabFichiers :
        MonTexte1.txt
        MonTexte2.txt
        Dossier1/MonTexte3.txt
        Dossier1/MonTexte4.txt
        Dossier2/MonTexte5.txt
        Dossier2/Dossier3/MonImage1.png

 
PROPRIÉTÉS 

Produit : 4D
Thème : Documents système
Numéro : 474
Nom intl. : DOCUMENT LIST

Cette commande modifie la variable système Error

 
HISTORIQUE 

Créé : 4D v6
Modifié : 4D v13

 
VOIR AUSSI  

LISTE DES DOSSIERS
LISTE DES VOLUMES

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Hérité de : LISTE DES DOCUMENTS ( 4D v11 SQL Release 6)