_findfirsti64, _wfindfirsti64
Nach oben zu io.h - Index
Header-Datei
io.h, wchar.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
long _findfirsti64(char *filter, struct _finddatai64_t *fileinfo);
long _wfindfirsti64(wchar_t *filter, struct _wfinddatai64_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 i64-Versionen sind für die Verwendung von 64-Bit-Dateigrößen vorgesehen und 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 File specification that could not be matched (Datei oder Verzeichnis nicht gefunden)
EINVAL Invalid filename specification (Ungültige Dateinamensangabe)
Beispiel
#include <io.h> void print_dir(wchar_t* dir_name) { /* Open a find stream (_wfinddatai64_t and a find handle) */ _wfinddatai64_t find_data; long handle = _wfindfirsti64(dir_name, &find_data); /* Check for errors */ if (!handle) return; /* Scan all files that mach */ do { printf("%ls\n", find_data.name); } while (!_wfindnexti64(handle, &find_data)); /* Close the find handle */ _findclose(handle); }
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findfirsti64 |
+ |
|||
_wfindfirsti64 |
Nur NT |