FC_DirListCreate - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab	SystemInterface_1.32.6.0
Versionen:	Aktuelle Version

Aufgabe

Nach einer oder mehreren Dateien suchen und eine Liste der gefundenen Dateien erstellen.

Beschreibung

Mit der Funktion wird eine Liste der Dateien erzeugt. Sie können einen Filter für die Dateinamen in die Funktion FC_DirListCreate() übertragen. Diese Funktion durchsucht alle Dateien in dem angegebenen Verzeichnis, die dem Suchfilter i_sSearchFilter entsprechen. Namen und Größe der Dateien werden in einer Liste gespeichert. Die Anzahl der gefundenen Dateien wird zurückgegeben. Mit der Funktion FC_DirListEntryGet() können Sie die gefundenen Dateiinformationen aus der Liste auslesen. Auf folgenden Geräten kann nach Dateien gesucht werden:

oide0:

oram0:

Es ist nicht möglich, auf Remote-Geräten nach Dateien zu suchen. Das Standardgerät ist "ide0:".

Der Anwender muss den Gerätenamen (außer beim Standardgerät) im Übergabeparameter i_sSearchFilter angeben. Gerätename und Suchfilter müssen durch Backslash '\' getrennt sein. Folgende Sonderzeichen können verwendet werden:

Sternchen: * => beliebige Zeichen in der Anzahl 0-n

Punkt: . => Trennung zwischen Dateiname und Dateierweiterung

Die Dateiinformationen stehen permanent nach Beendigung der Funktion FC_DirListCreate() zur Verfügung. Durch erneuten Aufruf der Funktion FC_DirListCreate() werden die Dateiinformationen aktualisiert. Die Dateiinformationen werden gelöscht, wenn das Programm zurückgesetzt wird.

HINWEIS: Die Abarbeitung dieser Funktion dauert typisch einige 10 ms. Deshalb sollten die Zeiten für die Zyklusüberwachung der Task, in der diese Funktion ausgeführt wird, einmalig erhöht werden. Beispiel: FC_CycleCheckTimeSet(50, 100).

Schnittstelle

Eingang	Datentyp	Beschreibung
i_sSearchFilter	STRING[80]	Filter für Dateinamen, nach denen gesucht werden soll

Rückgabewert

Datentyp	Beschreibung
DINT	>= 0: Anzahl der gefundenen Dateien bzw. Verzeichnisse, die dem übergebenen Suchfilter entsprechen. -1: Das angegebene Gerät wurde nicht gefunden oder das angegebene Gerät ist ein Remote-Gerät.

Beispiele

FC_DirListCreate ('*.*');

-> Es wird nach allen Dateien auf "ide0:" gesucht.

FC_DirListCreate ('*');

-> Es wird nach allen Dateien inklusive Verzeichnissen auf "ide0:" gesucht.

FC_DirListCreate ('ram0:\*.*');

-> Es wird nach allen Dateien auf "ram0:" gesucht.

FC_DirListCreate ('*.mon');

-> Es wird nach alle Tracedateien auf "ide0:" gesucht.

FC_DirListCreate ('aa*.*');

-> Es wird nach allen Dateien auf "ide0:" gesucht, deren Dateinamen mit "aa" beginnt.

FC_DirListCreate ('a*b.*');

-> Es wird nach allen Dateien auf "ide0:" gesucht, deren Dateinamen mit "a" beginnt und mit "b" endet. Die Zeichen dazwischen sind beliebig.