_findfirst, __wfindfirst
Nach oben zu io.h - Index
Header-Datei
io.h, wchar.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
long _findfirst(char *filter, struct _finddata_t *fileinfo);
long __wfindfirst(wchar_t *filter, struct _wfinddata_t *fileinfo);
Beschreibung
Durchsucht ein Datenträgerverzeichnis nach Informationen zum ersten Vorkommen eines Dateinamens, der dem angegebenen Filter entspricht. Der Parameter filter ist ein String, der angibt, nach welchen Dateien gesucht wird. Im Filter können Platzhalterzeichen verwendet werden. Der Parameter fileinfo steht für den Dateiinformationspuffer. Wenn eine passende Datei gefunden wird, werden die Datei- und Verzeichnisdaten in die Struktur fileinfo eingetragen.
Diese Funktionen werden aus Gründen der Kompatibilität mit Microsoft bereitgestellt.
Rückgabewert
Bei erfolgreicher Ausführung wird ein eindeutiges Such-Handle für eine Datei oder Gruppe von Dateien zurückgegeben, die der Filterspezifikation entspricht.
Andernfalls wird –1 zurückgegeben und errno einer der folgenden Werte zugewiesen:
ENOENT Path or file name not found (Pfad oder Dateiname nicht gefunden)
EINVAL Invalid filename specification (Ungültige Dateinamensangabe)
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findfirst |
+ |
|||
__wfindfirst |
Nur NT |