File and Path Function

intptr_t _findfirst(const char* filespec, struct __finddata_t* fileinfo);

intptr_t _wfindfirst(const wchar_t* filespec, struct __finddata_t* fileinfo);

intptr_t _tfindfirst(const TCHAR* filespec, struct __tfinddata_t* fileinfo);

intptr_t _findfirst64(const char* filespec, struct __finddata64_t* fileinfo);

intptr_t _wfindfirst64(const wchar_t* filespec, struct __finddata64_t* fileinfo);

intptr_t _tfindfirst64(const TCHAR* filespec, struct __tfinddata64_t* fileinfo);

intptr_t _findfirsti64(const char* filespec, struct __finddatai64_t* fileinfo);

intptr_t _wfindfirsti64(const wchar_t* filespec, struct __finddatai64_t* fileinfo);

intptr_t _tfindfirsti64(const TCHAR* filespec, struct __tfinddatai64_t* fileinfo);

Internationalization (I18n) Function Overview

The _findfirst function searches for the first instance of a filename that matches the file specified in the filespec argument. If found, it provides file information about the file and returns a unique search handle to be used in subsequent calls to _findnext; otherwise, it returns -1 and sets the global error, errno.

After finishing the calls to _findfirst and _findnext, _findclose must be called to free up the resources used by the calls.

_wfindfirst is the wide-character version of _findfirst, using wide-character arguments.

_findfirst64 and _findfirsti64, and their wide-character variations, support different fileinfo structures.

_tfindfirst, _tfindfirst64, and _tfindfirsti64 are the Generic versions; with the _MBCS or _UNICODE compiler flags determining their mapping to the corresponding multibyte or wide-character versions.

See the MSDN library for more information.

I18n Issues

Use the appropriate version of the function as required for internationalization support.

See Pathnames for a discussion of path and filename considerations in an internationalized application.

Recommended Replacements*

Microsoft Windows MBCS	_findfirst,_findfirst64,_findfirsti64
Microsoft Windows Unicode	_wfindfirst,_wfindfirst64,_wfindfirsti64
Microsoft Windows Generic	_tfindfirst,_tfindfirst64,_tfindfirsti64

File and Path Functions