_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