FExists()
Allgemeines
Die Funktion fExists() prüft, ob eine Datei existiert. Optional kann diese Prüfung mit dem Vorhandensein bestimmter Attribute verknüpft werden. Existiert die Datei UND sind die definierten Attribute gesetzt, liefert die Funktion den Wert .T. zurück.
Im Gegensatz zu File() sucht fExists() unabhängig von den Systemeinstellungen SET PATH bzw. SET DEFAULT.
Syntax
fExist(<cFileName>, [<cFileAttributes>]) => lExists
Parameter
<cFileName> gibt die Datei an, deren Existenz geprüft werden soll. Befindet sich die Datei nicht im aktuellen Verzeichnis, müssen gegebenenfalls Laufwerk und Verzeichnis mit angegeben werden.
<cFileAttributes> definiert optionale Dateiattribute, die neben der reinen Existenz geprüft werden sollen. Die verwendeten Werte entsprechen denen, die bei der Funktion fAttr() verwendet werden (mit Ausnahme der Werte "N" und "C").
| Attribut | Bedeutung | Erläuterung |
|---|---|---|
| D | Directory/Verzeichnis | die Datei ist ein Verzeichnis |
| H | Hidden/versteckt | die Datei wird normalerweise nicht angezeigt/gelistet |
| S | System | es handelt sich um eine System-Datei |
| R | Read-Only/nur Lesen | es handelt sich um eine Datei, die nur gelesen werden kann |
| A | Archive/Archiv-Flag | die Datei wurde seit dem letzten Backup, das dieses Attribut löscht, geändert |
Neben der reinen Attribut-Prüfung gibt es die Möglichkeit, die Merkmale in der Prüfung zu modifzieren:
| Attribut | Bedeutung | Erläuterung |
|---|---|---|
| + | dieses Attribut muss bei der Datei vorhanden (gesetzt) sein | |
| - | Dateien, bei denen dieses Attribut gesetzt ist, werden ignoriert | |
| = | die Standardeinstellungen werden ignoriert, anstelle dessen wird eine genaue Übereinstimmung erzwungen. Dieses Präfix muss das erste Zeichen in der Maske sein. | |
| * | die definierten Attribute müssen gesetzt sein, unabhängig davon, ob andere Attribute gesetzt sind. Der Stern muss das letzte Zeichen in der Maske sein. |
Rückgabewert
lExists enthält den Wert .T., wenn eine Datei mit den definierten Attributen existiert. Andernfalls gibt die Funktion .F. zurück.
Querverweise
benötigte DLLs bzw. Include-Dateien
XppUI1.lib
FileIO.ch