檔案名稱搜尋函式
這些函式會針對指定的檔案名稱進行搜尋或關閉搜尋：
備註
_findfirst 函式提供檔案名稱第一個執行個體的相關資訊，此檔案名稱與 filespec 引數所指定的檔案相符。 您可以在 filespec 使用主機作業系統支援的任何萬用字元組合。
函式會傳回 結構中的 _finddata_t 檔案資訊，其定義於 中 IO.h。 家族中的不同函式在 _finddata_t 結構上有多種變化。 基本 _finddata_t 結構包含下列項目：
unsigned attrib
檔案屬性。
time_t time_create
檔案建立時間（-1L 適用於 FAT 檔案系統）。 此時間以 UTC 格式儲存。 若要轉換為本地時間，請使用 localtime_s。
time_t time_access
最後一個檔案存取的時間（-1L 適用於 FAT 檔案系統）。 此時間以 UTC 格式儲存。 若要轉換為本地時間，請使用 localtime_s。
time_t time_write
上次寫入檔案時間。 此時間以 UTC 格式儲存。 若要轉換為本地時間，請使用 localtime_s。
_fsize_t size
檔案的長度 (以位元組為單位)。
char name[ _MAX_PATH] NULL相符檔案或目錄的終止名稱，不含路徑。
在不支援建立和上次存取檔案的檔案系統中，例如 FAT 系統， time_create 和 time_access 欄位一律 -1L為 。
_MAX_PATH 定義為 Stdlib.h 260 個字節。
您無法指定目標屬性 （例如 _A_RDONLY） 來限制尋找作業。 這些屬性會在 結構的 欄位中_finddata_t傳attrib回，而且可以有下列值（定義於 IO.h中）。 使用者不應依賴這些屬性是欄位唯一可能 attrib 的值。
_A_ARCH
封存。 每當命令變更並清除 BACKUP 檔案時設定。 值： 0x20。
_A_HIDDEN
隱藏的檔案。 除非您使用 /AH 選項，否則通常不會使用 DIR 命令。 傳回有關一般檔案或具有此屬性之檔案的資訊。 值： 0x02。
_A_NORMAL
一般。 未設定其他屬性，而且可不受限制進行讀取或寫入的檔案。 值： 0x00。
_A_RDONLY
唯讀。 無法開啟檔案以進行寫入，而且無法建立具有相同名稱的檔案。 值： 0x01。
_A_SUBDIR
子目錄。 值： 0x10。
_A_SYSTEM
系統檔案。 除非使用 或 /A:S 選項，否則/A通常不會使用 DIR 命令。 值： 0x04。
如果有符合稍早_findnext 呼叫中所指定 filespec 引數的名稱， _findfirst便會往下搜尋。 fileinfo 引數應該會指向由先前 _findfirst呼叫所初始化的結構。 如果找到相符名稱， fileinfo 結構內容便會如上述方式變更。 否則，會維持不變。 _findclose 會關閉指定的搜尋控制代碼，並為 _findfirst 和 _findnext同時釋出相關聯的資源。 由 _findfirst 或 _findnext 之一所傳回的控制代碼必須先傳遞到 _findclose，然後才能在組成其傳遞路徑的目錄上執行修改作業，例如刪除。
您可以將 _find 函式巢狀化。 例如，如果 _findfirst 或 _findnext 的呼叫發現是子目錄的檔案，就可以另外使用 _findfirst 或 _findnext呼叫來啟始新的搜尋。
_wfindfirst 和 _wfindnext 是寬字元版本的 _findfirst 和 _findnext。 寬字元版本的 structure 自變數具有 _wfinddata_t 數據類型，其定義於 和 中IO.hWchar.h。 此數據類型的欄位與數據類型的_finddata_t欄位相同，不同之處在於_wfinddata_tname欄位中的類型不是 wchar_t 類型char。 否則， _wfindfirst 和 _wfindnext 的行為與 _findfirst 和 _findnext相同。
_findfirst 和 _findnext 皆使用 64 位元時間類型。 如果您必須使用舊的 32 位元時間類型，則可以定義 _USE_32BIT_TIME_T。 名稱中具有 32 後綴的這些函式版本會使用 32 位時間類型，而後綴為 64 的函式則使用 64 位時間類型。
函式 _findfirst32i64、 _findnext32i64、 _wfindfirst32i64和 _wfindnext32i64 的行為也與這些函式版本的 32 位元時間類型相同，除非這些函式使用並傳回 64 位元的檔案長度。 函式 _findfirst64i32、 _findnext64i32、 _wfindfirst64i32和 _wfindnext64i32 使用 64 位元時間類型，但使用 32 位元檔案長度。 這些函式皆使用適當的 _finddata_t 類型變化，此類型中的欄位類型針對時間和檔案大小會有所不同。
_finddata_t 事實上是評估 _finddata64i32_t (或 _finddata32_t 遭拒則為 _USE_32BIT_TIME_T ) 的巨集。 下表摘要說明 _finddata_t的各種版本：
| 結構 | 時間類型 | 檔案大小類型 |
|---|---|---|
_finddata_t, _wfinddata_t |
__time64_t |
_fsize_t |
_finddata32_t, _wfinddata32_t |
__time32_t |
_fsize_t |
__finddata64_t, _wfinddata64_t |
__time64_t |
__int64 |
_finddata32i64_t, _wfinddata32i64_t |
__time32_t |
__int64 |
_finddata64i32_t, _wfinddata64i32_t |
__time64_t |
_fsize_t |
_fsize_t 是 unsigned long (32 位元) 的 typedef。
範例
// crt_find.c
// This program uses the 32-bit _find functions to print
// a list of all files (and their attributes) with a .C extension
// in the current directory.
#include <stdio.h>
#include <stdlib.h>
#include <io.h>
#include <time.h>
int main( void )
{
struct _finddata_t c_file;
intptr_t hFile;
// Find first .c file in current directory
if( (hFile = _findfirst( "*.c", &c_file )) == -1L )
printf( "No *.c files in current directory!\n" );
else
{
printf( "Listing of .c files\n\n" );
printf( "RDO HID SYS ARC FILE DATE %25c SIZE\n", ' ' );
printf( "--- --- --- --- ---- ---- %25c ----\n", ' ' );
do {
char buffer[30];
printf( ( c_file.attrib & _A_RDONLY ) ? " Y " : " N " );
printf( ( c_file.attrib & _A_HIDDEN ) ? " Y " : " N " );
printf( ( c_file.attrib & _A_SYSTEM ) ? " Y " : " N " );
printf( ( c_file.attrib & _A_ARCH ) ? " Y " : " N " );
ctime_s( buffer, _countof(buffer), &c_file.time_write );
printf( " %-12s %.24s %9ld\n",
c_file.name, buffer, c_file.size );
} while( _findnext( hFile, &c_file ) == 0 );
_findclose( hFile );
}
}
Listing of .c files
RDO HID SYS ARC FILE DATE SIZE
--- --- --- --- ---- ---- ----
N N N Y blah.c Wed Feb 13 09:21:42 2002 1715
N N N Y test.c Wed Feb 06 14:30:44 2002 312