_findfirst、__wfindfirst
io.h:インデックス への移動
ヘッダー
io.h、wchar.h
カテゴリ
ディレクトリ制御ルーチン
プロトタイプ
long _findfirst(char *filter, struct _finddata_t *fileinfo);
long __wfindfirst(wchar_t *filter, struct _wfinddata_t *fileinfo);
説明
ディスクのディレクトリの検索を開始し、指定されたフィルタに一致する最初のファイル名に関する情報を見つけます。この filter パラメータは、取得するファイルを指定する文字列です。フィルタには、ワイルドカードを使用できます。fileinfo パラメータは、ファイル情報のバッファです。一致するファイルが見つかると、fileinfo 構造体にファイルディレクトリ情報が格納されます。
これらの関数は、Microsoft との互換性のために提供されています。
戻り値
成功した場合は、フィルタ指定に一致するファイルまたはファイル グループの一意の検索ハンドルを返します。
そうでない場合は -1 を返し、errno を次のいずれかの値に設定します。
ENOENT - パスまたはファイル名が見つからない
EINVAL - ファイル名の指定が無効
移植性
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findfirst |
+ |
|||
__wfindfirst |
NT のみ |