Bezeichnung
xad.LocateFile -- sucht nach einer Datei im XAD-Archiv
Übersicht
idx = xad.LocateFile(id, name$[, table])
Beschreibung
Dieser Befehl sucht nach der Datei name$ innerhalb des in id angegebenen xad-Archivs und gibt ihren Index zurück, wenn sie gefunden wurde, andernfalls -1.

Mit dem optionalen Argument table können weitere Optionen angegeben werden. Folgende Tabellentags werden derzeit erkannt:

NoCase:
Wenn dieser Tag auf True gesetzt ist, unterscheidet xad.LocateFile() nicht zwischen Groß- und Kleinbuchstaben. Dies macht die Suche langsamer. Der Standardwert ist False.

NoDir:
Wenn dieser Tag auf True gesetzt ist, wird xad.LocateFile() nur nach Dateinamen suchen. So wird dieser Befehl auch fündig, wenn sich die Datei in einem Unterverzeichnis im Archiv befindet. Der Standardwert ist False.

Eingaben
id
Identifikator des zu verwendenden XAD-Archivs
name$
Name der zu suchenden Datei
table
optional: Tabellenargument mit weiteren Optionen (siehe oben)
Rückgabewerte
idx
Index der Datei im XAD-Archiv oder -1, wenn sie nicht gefunden wurde
Navigation zeigen