TurboPL Referenz

FirstDir

Top  Previous  Next

Syntax

FirstDir(Suchmuster: String; Attribute: String): String

Diese Funktion existiert lediglich aus Kompatibilitätsgründen und kann keine langen Dateinamen verarbeiten. Bitte verwenden Sie zukünftig nur die erweiterten Funktionen FindFirstFile und FindNextFile.

Kategorie

Basisfunktion

Erklärung

Sucht den ersten Verzeichniseintrag, der dem Suchmuster und den Attributen entspricht und liefert einen String mit dem Dateinamen, der Dateigröße und weiteren Angaben zurück. Das Suchmuster enthält normalerweise Joker-Zeichen wie z.B. "*.*" oder "*.DAT" oder "MAI???.K*". Attribute gibt an, welche Dateien zusätzlich zu den normalen Dateien gesucht werden sollen und stimmt mit den Attributen im Datei-Manager überein:

R                                Nur lesen (Read Only)

A                                Archiv

S                                System-Datei

H                                Versteckt (Hidden)

V                                Datenträger-Bezeichnung (Volume ID)

D                                Verzeichnisse (Directory)

Anstelle eines Attribut-Strings kann auch das Zeichen "X" angegeben werden. In diesem Fall enthält der Rückgabestring den kompletten Pfad zur angegebenen Datei.

Der Rückgabe-String enthält Angabe über die gefundene Datei:

Zeichen                                Inhalt

1..12                                Dateiname mit Extension

15..24                                Dateigröße in Byte

27..36                                Datei-Datum

39..43                                Datei-Zeit

46                                "R" bei Nur-lesen-Dateien, ansonsten leer

47                                "H" bei versteckten Dateien, ansonsten leer

47                                "S" bei System-Dateien, ansonsten leer

47                                "V" bei Datenträger-Bezeichnung, ansonsten leer

47                                "D" bei Verzeichnissen, ansonsten leer

47                                "A" bei Archiv-Dateien, ansonsten leer

54..                                Verzeichnis-Name

Beispiel

Ausdruck des aktuellen Verzeichnisses:

procedure VerzeichnisDrucken;
       vardef S: String;
       S := FirstDir("*.*", "");
       while S <> ""
               Print(S/);
               S := NextDir;
       end
endproc

Siehe auch

NextDir