bs2fstat - BS2000-Dateinamen aus Katalog ermitteln (BS2000)

Definition	#include <stdlib.h> int bs2fstat(const char *pattern, void (*function)(const char *filename, int len));
Beschreibung	bs2fstat liefert den vollqualifizierten Dateinamen (:catid:$userid.dateiname) von Dateien, die das Auswahlkriterium pattern erfüllen, sowie die Länge des jeweiligen Dateinamens inklusive des abschließenden Nullbytes (\0). Für jede gefundene Datei ruft bs2fstat eine vom Benutzer bereitzustellende Funktion function auf und übergibt an diese als aktuelle Argumente den jeweiligen Dateinamen filename (Zeichenkette char *) und die Namenslänge len (ganze Zahl). const char *pattern ist eine Zeichenkette, die das Auswahlkriterium für einen oder mehrere Dateinamen angibt. pattern ist ein voll- oder teilqualifizierter Dateiname mit Wildcard-Syntax. Außerdem können aus Kompatibilitätsgründen weitere Parameter angegeben werden, die die Auswahl der Dateien beeinflussen, z.B: Datei- und Katalogeigenschaften (FCBTYPE, SHARE etc.) Erstellungs- und Zugriffsdatum (CRDATE, EXDATE etc.) Diese Parameter müssen in der Syntax des ISP-Kommandos FSTAT angegeben werden. Beispielsweise liefert das Muster "*,crdate=today" die Namen aller Dateien, die am jeweils heutigen Tag erstellt bzw. verändert wurden. void (*function)(const char *filename, int len) ist eine vom Benutzer bereitzustellende Funktion mit den Parametern filename (Dateiname) und len (Namenslänge). Diese Parameter werden von bs2fstat bei jedem Funktionsaufruf mit aktuellen Werten versorgt. Die Funktionsaufrufe erfolgen durch bs2fstat automatisch (in einer while-Schleife).
Returnwert	0	bei Erfolg.
	DMS-Fehlermeldungscode
		bei Fehler.
Hinweis	Das Kennzeichen für DMS-Fehlermeldungen kann nur außerhalb der benutzereigenen Funktion function abgefragt werden, da bei erfolgloser Suche die Funktion nicht aufgerufen wird.
Siehe auch	system(), stdio.h.