Programmieren mit dBASE PLUS: Funktionen: dirExt

dirExt( ) ist eine erweiterte Version der Methode dir( ). Sie füllt das Array mit den neun Merkmalen der angegebenen Dateien: Dateiname, Größe, Änderungsdatum, Änderungszeit, DOS-Attribute, kurzer Dateiname (8.3), Erstellungsdatum, Erstellungszeit und Datum des letzten Zugriffs. Nach der Operation wird die Anzahl der Dateien zurückgegeben, deren Merkmale gespeichert wurden.

Syntax

<oReferenz>.dirExt([<Dateiauswahl AusdruckZ> [, <DOS-Dateiattribute AusdruckZ>]]

<oReferenz>

Ein Bezug auf das Array, in dem die Dateiinformationen gespeichert werden. Die Größe des Arrays wird entsprechend den Informationen dynamisch geändert.

<Dateiauswahl AusdruckZ>

Die Dateien, deren Informationen in <oReferenz> gespeichert werden sollen. Bei der Angabe sind Platzhalterzeichen zulässig.

<DOS-Dateiattribute AusdruckZ>

Die mit den Buchstaben D, H, S und/oder V angegebenen DOS-Dateiattribute.

Soll ein Wert für <DOS-Dateiattribute AusdruckZ> festgelegt werden, muß auch ein Wert oder "*.*" für <Dateiauswahl AusdruckZ> angegeben werden.

Die Attribute haben folgende Bedeutung:

Zeichen
D	Verzeichnis
H	Verborgene Datei
S	Systemdatei
V	Volume-Bezeichnung

Mehrere für <DOS-Dateiattribute AusdruckZ> angegebene Buchstaben müssen hintereinander in Anführungszeichen gesetzt werden. Ein Beispiel:

aFiles.dirExt("*.*", "HS")

Eigenschaft von

Array

Beschreibung

Mit dirExt( ) können Sie Dateiinformationen in einem Array speichern, dessen Größe dabei dynamisch geändert wird. Das resultierende Array ist immer zweidimensional. Werden keine Dateien gefunden, wird das Array nicht geändert. Ohne Angabe des Parameters <Dateiauswahl AusdruckZ> werden Informationen über alle Dateien (mit Ausnahme der System- und verborgenen Dateien) im aktuellen Verzeichnis gespeichert. Sollen beispielsweise nur Informationen zu DBF-Tabellen gespeichert werden, geben Sie "*.DBF" als <Dateiauswahl AusdruckZ> an.

Sollen auch Verzeichnisse, verborgene Dateien und Systemdateien in das Array aufgenommen werden, verwenden Sie den Parameter <DOS-Dateiattribute AusdruckZ>. Mit Hilfe der Buchstaben D, H und S können Sie festlegen, welche dieser Dateien zusätzlich im Array gespeichert werden. Die Dateinamen müssen natürlich mit <Dateiauswahl AusdruckZ> übereinstimmen. Wird V im Parameter <DOS-Dateiattribute AusdruckZ> angegeben, werden <Dateiauswahl AusdruckZ> sowie andere in der Attributliste enthaltene Angaben ignoriert und die Volume-Bezeichnung im ersten Element des Arrays gespeichert.

dirExt( ) speichert folgende Informationen für jede Datei in jeweils einer Array-Zeile. Der entsprechende Datentyp ist in Klammern angegeben:

Spalte 1	Spalte 2	Spalte 3	Spalte 4	Spalte 5
Dateiname (Zeichen)	Größe (Numerisch)	Änderungsdatum (Datum)	Änderungszeit (Zeichen)	DOS-Dateiattribut(e) (Zeichen)
Spalte 6	Spalte 7	Spalte 8	Spalte 9
Kurzer Dateiname (8.3) (Zeichen)	Erstellungsdatum (Datum)	Erstellungszeit (Zeichen)	Zugriffsdatum (Datum)

Spalte 5 (DOS-Dateiattribute) kann eines oder mehrere der folgenden Attribute enthalten:

Attribut	Bedeutung
R	Schreibgeschützte Datei
A	Archivdatei (seit der letzten Sicherung geändert)
S	Systemdatei
H	Verborgene Datei
D	Verzeichnis

Sind bei einer Datei Attribute gesetzt, wird der betreffende Buchstabe in der Spalte angezeigt. Andernfalls ist hier ein Punkt zu sehen. Beispielsweise wird für eine Datei ohne eines dieser Attribute folgender String in Spalte 5 angezeigt:

.....

Für eine schreibgeschützte, verborgene Datei wird folgender String in Spalte 5 angezeigt:

R..H.

Mit Hilfe von dir( ) erhalten Sie die Grundinformationen zu einer Datei.