Bezeichnung
GetFileAttributes -- gibt die Attribute einer Datei oder eines Verzeichnisses zurück (V3.0)
Übersicht
t = GetFileAttributes(f$[, table])
Frühere syntax
t = GetFileAttributes(f$[, adapter$])
Beschreibung
Dieser Befehl gibt die Tabelle t zurück, die die Attribute einer Datei oder eines Verzeichnisses enthält. Dazu gehören Informationen wie die Dateizeit, den vollständigen Pfad der Datei, Schutzkennzeichen und mehr (ist vom Host-Dateisystem abhängig). Übergeben Sie diesem Befehl den Namen einer Datei oder eines Verzeichnisses in f$. Sie können eine leere Zeichenkette ("") angeben, um Informationen über das aktuelle Verzeichnisses zu erhalten.

Dieser Befehl akzeptiert ein optionales Tabellenargument table, das verwendet werden kann, um zusätzliche Parameter zu übergeben. Die folgenden Tabellenelemente werden derzeit erkannt:

Adapter:
Mit diesem Tag können Sie ein oder mehrere Dateiadapter angeben, die die angegebene Datei öffnen sollen. Dies muss als eine Zeichenkette festgelegt werden, die den/die Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird der Adapter verwendet, der mit SetDefaultAdapter() gesetzt wurde. Siehe Lade- und Adaptermodule für Details. (V6.0)

UserTags:
Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an den Dateiadapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

Die Tabelle wird mit folgenden Feldern initialisiert:

Type:
Dies wird #DOSTYPE_FILE sein, wenn f$ eine Datei oder #DOSTYPE_DIRECTORY, falls f$ ein Verzeichnis ist.

Path:
Dieses Feld wird eine Zeichenfolge mit dem vollständigen Pfad zu dieser Datei oder dem Verzeichnis enthalten.

Size:
Dieses Feld ist nur vorhanden, wenn in f$ eine Datei übergeben wurde. In diesem Fall wird dieses Feld die Größe der Datei in Bytes enthalten.

Flags:
Dieses Feld wird eine Kombination aus Schutzbits der Datei oder des Verzeichnisses enthalten. Siehe Schutzbits Informationen für Details.

Time:
Dieses Feld wird eine Zeichenkette mit der Datei- oder Verzeichniszeit enthalten, wann sie zuletzt geändert wurde. Die Zeichenkette wird immer im Format dd-mmm-jjjj hh: mm: ss. übergeben, Z. B . 08-Nov-2004 14:32:13.

LastAccessTime:
Dieses Feld wird eine Zeichenkette mit der Datei- oder Verzeichniszeit enthalten, wann zuletzt auf die Datei/dem Verzeichnis zugegriffen wurde. Dieses Attribut wird nicht auf AmigaOS unterstützt.

CreationTime:
Dieses Feld wird eine Zeichenkette mit der Zeit der Datei oder dem Verzeichnis enthalten, wann sie/es erstellt wurde. Dieses Attribut wird nur auf Windows unterstützt.

Comment:
Dieses Feld wird den Kommentar einer Datei enthalten. Wird nur von den Amigaversionen unterstützt.

Virtual:
Dieses Feld wird auf True gesetzt, wenn die Datei, die Sie diesem Befehl übergeben haben, eine virtuelle ist. d.h. es ist eine mit Ihrem Applet/ausführbaren Programm verknüpfte Datei oder eine mit dem Befehl DefineVirtualFile() erstellte Datei. (V5.2)

Wenn Sie die Attribute einer Datei abfragen möchten, die Sie mit dem Befehl OpenFile() geöffnet haben, verwenden Sie stattdessen den Befehl FileAttributes(). Siehe FileAttributes für Details.

Siehe auch SetFileAttributes().

Eingaben
f$
Name der Datei oder Verzeichnis
table
optional: Tabelle mit weiteren Optionen (siehe oben) (V10.0)
Rückgabewerte
t
eine Tabelle, die wie oben gezeigt initialisiert wird
Beispiel
t = GetFileAttributes("test.txt")
Print(t.time)
If t.flags & #FILEATTR_READ_USR
  Print("#FILEATTR_READ_USR is set.")
Else
  Print("#FILEATTR_READ_USR is not set.")
EndIf
Der obige Code prüft die Datei "test.txt" und gibt die Zeit, als sie zuletzt geändert wurde, auf dem Bildschirm aus. Außerdem prüft sie, ob der Schutzbit #FILEATTR_READ_USR gesetzt ist.
Navigation zeigen