4D Doc Center : DOCUMENT LIST

Home

4D v14.3

DOCUMENT LIST


DOCUMENT LIST ( Pfadname ; Dokumente {; Optionen} )

Parameter	Typ	Beschreibung
Pfadname	String	Pfadname zu Volume, Festplatte oder Ordner
Dokumente	Array Text	Namen der an dieser Stelle vorhandenen Dokumente
Optionen	Lange Ganzzahl	Optionen zum Erstellen von Listen

Beschreibung

Der Befehl DOCUMENT LIST füllt das Array Dokumente mit den Namen der Dokumente, die unter dem in Pfadname übergebenen Pfadnamen liegen.

Hinweis: Pfadname akzeptiert nur absolute Pfadnamen.

Standardmäßig, d.h. ohne den Parameter Optionen werden im Array Dokumente nur die Namen der Dokumente zurückgegeben. Das können Sie ändern, wenn Sie im Parameter Optionen eine bzw. mehrere der folgenden Konstanten unter dem Thema Systemdokumente übergeben:

Konstante	Typ	Wert	Meldung
Absolute path	Lange Ganzzahl	2	Das Array Dokumente enthält absolute Pfadnamen
Ignore invisible	Lange Ganzzahl	8	Unsichtbare Dokumente werden nicht aufgelistet
Posix path	Lange Ganzzahl	4	Das Array Dokumente enthält Pfadnamen im Posix Format
Recursive parsing	Lange Ganzzahl	1	Das Array Dokumente enthält alle Dateien und Unterordner des angegebenen Ordners

Hinweise:

Mit der Option Recursive parsing im relativen Modus (nur Option 1), beginnen die Pfade von Dokumenten in Unterordnern je nach Plattform mit dem Zeichen ":" oder "\" .
Mit der Option Posix path im relativen Modus (nur Option 4) beginnen Pfade nicht mit "/".
Mit der Option Posix path im absoluten Modus (Optionen 4 + 2) beginnen Pfade immer mit "/".

Gibt es keine Dokumente an der angegebenen Stelle, gibt der Befehl ein leeres Array zurück. Ist der in Pfadname übergebene Pfadname ungültig, erzeugt DOCUMENT LIST einen OS Systemfehler, den Sie mit einer Methode ON ERR CALL abfangen können.

Beispiel 1

Liste aller Dokumente in einem Ordner (Standardsyntax):

DOCUMENT LIST("C:\\";arrFiles)

-> arrFiles:
Text1.txt
Text2.txt

Beispiel 2

Liste aller Dokumente in einem Ordner im absoluten Modus:

DOCUMENT LIST("C:\\";arrFiles; Absolute path)

-> arrFiles:
C:\Text1.txt
C:\Text2.txt

Beispiel 3

Liste aller Dokumente im rekursiven (relativen) Modus:

DOCUMENT LIST("C:\\";arrFiles;Recursive parsing)

-> arrFiles:
       Text1.txt
       Text2.txt
        \Folder1\Text3.txt
       \Folder1\Text4.txt
       \Folder2\Text5.txt
       \Folder2\Folder3\Picture1.png

Beispiel 4

Liste aller Dokumente im rekursiven absoluten Modus:

DOCUMENT LIST("C:\\MyFolder\\";arrFiles;Recursive parsing+Absolute path)

-> arrFiles:
        C:\MyFolder\MyText1.txt
        C:\MyFolder\MyText2.txt
        C:\MyFolder\Folder1\MyText3.txt
        C:\MyFolder\Folder1\MyText4.txt
        C:\MyFolder\Folder2\MyText5.txt
        C:\MyFolder\Folder2\Folder3\MyPicture1.png

Beispiel 5

Liste aller Dokumente im rekursiven Posix (relativen) Modus:

DOCUMENT LIST("C:\\MyFolder\\";arrFiles;Recursive parsing+Posix path)

-> arrFiles:
        MyText1.txt
        MyText2.txt
        Folder1/MyText3.txt
        Folder1/MyText4.txt
        Folder2/MyText5.txt
        Folder2/Folder3/MyPicture1.png