findnext, _wfindnext
Nach oben zu dir.h - Index
Header-Datei
dir.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
int findnext(struct ffblk *ffblk );
int _wfindnext(struct _wffblk *ffblk );
Beschreibung
Setzt die durch findfirst begonnene Suche fort.
findnext dient zum Abruf nachfolgender Dateien, die den in findfirst angegebenen Pfadnamen aufweisen. Der Parameter ffblk enthält den Block, dem durch den findfirst-Aufruf ein Wert zugewiesen wird. Dieser Block enthält die zur Fortsetzung der Suche erforderlichen Informationen. Mit jedem Aufruf von findnext wird ein Dateiname zurückgegeben, bis in dem Verzeichnis mit dem angegebenen Pfadnamen keine Dateien mehr vorhanden sind.
Rückgabewert
findnext gibt 0 zurück, wenn eine Datei mit dem gesuchten Pfadnamen gefunden wurde. Wenn keine Dateien mehr vorhanden sind oder wenn der Dateiname falsch angegeben wurde:
-1 wird zurückgegeben,
errno wird folgender Wert zugewiesen:
ENOENT |
Path or file name not found (Pfad oder Dateiname nicht gefunden) |
_doserrno wird einer der folgenden Werte zugewiesen:
ENMFILE |
No more files (Keine weiteren Dateien) |
ENOENT |
Path or file name not found (Pfad oder Dateiname nicht gefunden) |
Beispiel
#include <stdio.h> #include <dir.h> void print_dir(wchar_t* dir_name) { /* Open a find stream (_wfinddata_t and a find handle) */ _wffblk find_data; int done; done = _wfindfirst(dir_name, &find_data, 0); /* Scan all files that mach */ while (!done) { printf("%ls\n", find_data.ff_name); done = _wfindnext(&find_data); } /* Close the find handle */ _wfindclose(&find_data); }
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
findnext |
+ |
|||
_wfindnext |
Nur NT |