_findfirst、_wfindfirst
filespec 引数に指定されたファイルと一致するファイル名の最初のインスタンスに関する情報を提供します。
intptr_t _findfirst(
const char *filespec,
struct _finddata_t *fileinfo
);
intptr_t _findfirst32(
const char *filespec,
struct _finddata32_t *fileinfo
);
intptr_t _findfirst64(
const char *filespec,
struct _finddata64_t *fileinfo
);
intptr_t _findfirsti64(
const char *filespec,
struct _finddatai64_t *fileinfo
);
intptr_t _findfirst32i64(
const char *filespec,
struct _finddata32i64_t *fileinfo
);
intptr_t _findfirst64i32(
const char *filespec,
struct _finddata64i32_t *fileinfo
);
intptr_t _wfindfirst(
const wchar_t *filespec,
struct _wfinddata_t *fileinfo
);
intptr_t _wfindfirst32(
const wchar_t *filespec,
struct _wfinddata32_t *fileinfo
);
intptr_t _wfindfirst64(
const wchar_t *filespec,
struct _wfinddata64_t *fileinfo
);
intptr_t _wfindfirsti64(
const wchar_t *filespec,
struct _wfinddatai64_t *fileinfo
);
intptr_t _wfindfirst32i64(
const wchar_t *filespec,
struct _wfinddata32i64_t *fileinfo
);
intptr_t _wfindfirst64i32(
const wchar_t *filespec,
struct _wfinddata64i32_t *fileinfo
);
パラメーター
filespec
ターゲット ファイルの指定 (ワイルドカード文字を含めることができます。fileinfo
ファイル情報バッファー。
戻り値
成功すると_findfirst は _findnext または _findclose への後続の呼び出しで使用できるfilespec の仕様に一致するファイルまたはファイル グループを識別する一意の検索ハンドルを返します。それ以外の場合は– 1 を返します _findfirst は次の値の 1 に errno を設定します。
EINVAL
無効なパラメーター : filespec または fileinfo は NULL いません。または予期しないエラーが返されました。ENOENT
一致指定できないファイル。ENOMEM
メモリ不足。EINVAL
無効なファイル名の指定またはファイル名は MAX_PATH を超えています。
リターン コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
無効なパラメーターが渡されるとこれらの関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。
解説
_findfirst または _findnext の関数が終了した後 _findclose を呼び出す必要があります (または変数)。これはアプリケーションでこれらの関数で使用されているリソースを解放します。
w のプレフィックスがこれらのバリエーションでは関数のワイド文字バージョンです。; それ以外の場合は対応するバイトの関数と同じものです。
これらの関数のバリエーションが 32 ビットまたは 64 ビットの時刻型および 32 ビットまたは 64 ビットのファイル サイズをサポートします。最初の数字サフィックス (または)3264 時刻型のサイズを表し ; 2 番目のサフィックスは i32 または i64 でファイル サイズが 32 ビットまたは 64 ビットの整数として表されるかを示します。バージョンが 32 ビットと 64 ビットの時刻型およびファイル サイズをサポートするついては次の表を参照してください。i32 または i64 のサフィックスは時刻型のサイズと同じ場合その _findfirst64 サポートする 64 ビットのファイル長を省略し_findfirst32 ファイル長は 32 ビットのみをサポートします。
これらの関数は fileinfo のパラメーターに _finddata_t のさまざまな形式の構造を使用します。構造体の詳細については_find、_wfind 系関数 を参照してください。
23:59 して表現される 64 ビットの時刻型の作成日時を使用する方法 : 593000 12 年 1 月 31 日のUTC。32 ビットの時刻型を使用するこれらは 19:14 は日付を示している場合 : 1 年 1 月 07 日 18 時 2038 の UTC。は1970 年が 1 年 1 月 1 日これらのすべての関数の日付範囲の下限はです。
時間のサイズを明示的に指定するバージョンを使用する特別な理由がない限り使用 _findfirst または _wfindfirst またはファイルの最大サイズは 3 GB をサポートする必要がある _findfirsti64 使用するかを _wfindfirsti64。これらの関数はすべて 64 ビットの時刻型を使用します。以前のバージョンではこれらの関数は32 ビットの時刻型を使用します。これはアプリケーションの互換性に影響の場合古い動作に戻すに _USE_32BIT_TIME_T を定義する必要があります。_USE_32BIT_TIME_T が定義されている場合_findfirst_finfirsti64 および対応する Unicode バージョンは 32 ビットの時刻を使用します。
時刻型およびファイル長は _findfirst のバリエーションを入力します。
関数 |
_USE_32BIT_TIME_T で定義したか。 |
時刻型 |
ファイル長の種類 |
---|---|---|---|
_findfirst, _wfindfirst |
定義なし |
64 ビット |
32 ビット |
_findfirst, _wfindfirst |
定義あり |
32 ビット |
32 ビット |
_findfirst32, _wfindfirst32 |
マクロ定義の影響は受けません |
32 ビット |
32 ビット |
_findfirst64, _wfindfirst64 |
マクロ定義の影響は受けません |
64 ビット |
64 ビット |
_findfirsti64, _wfindfirsti64 |
定義なし |
64 ビット |
64 ビット |
_findfirsti64, _wfindfirsti64 |
定義あり |
32 ビット |
64 ビット |
_findfirst32i64, _wfindfirst32i64 |
マクロ定義の影響は受けません |
32 ビット |
64 ビット |
_findfirst64i32, _wfindfirst64i32 |
マクロ定義の影響は受けません |
64 ビット |
32 ビット |
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tfindfirst |
_findfirst |
_findfirst |
_wfindfirst |
_tfindfirst32 |
_findfirst32 |
_findfirst32 |
_wfindfirst32 |
_tfindfirst64 |
_findfirst64 |
_findfirst64 |
_wfindfirst64 |
_tfindfirsti64 |
_findfirsti64 |
_findfirsti64 |
_wfindfirsti64 |
_tfindfirst32i64 |
_findfirst32i64 |
_findfirst32i64 |
_wfindfirst32i64 |
_tfindfirst64i32 |
_findfirst64i32 |
_findfirst64i32 |
_wfindfirst64i32 |
必要条件
Function |
必須ヘッダー |
---|---|
_findfirst |
<io.h> |
_findfirst32 |
<io.h> |
_findfirst64 |
<io.h> |
_findfirsti64 |
<io.h> |
_findfirst32i64 |
<io.h> |
_findfirst64i32 |
<io.h> |
_wfindfirst |
<io.h> または <wchar.h> |
_wfindfirst32 |
<io.h> または <wchar.h> |
_wfindfirst64 |
<io.h> または <wchar.h> |
_wfindfirsti64 |
<io.h> または <wchar.h> |
_wfindfirst32i64 |
<io.h> または <wchar.h> |
_wfindfirst64i32 |
<io.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
同等の .NET Framework 関数
System::IO::DirectoryInfo::GetFiles