fileName işlevleri ara

Bu işlevler, belirtilen dosya adlarını arar ve aramaları kapatır:

• _findnext, _wfindnext

• _findfirst, _wfindfirst

• _findclose

Açıklamalar

işlevi, _findfirst bağımsız değişkende filespec belirtilen dosyayla eşleşen bir dosya adının ilk örneği hakkında bilgi sağlar. Konak işletim sistemi tarafından desteklenen joker karakterlerin herhangi bir bileşiminde kullanabilirsiniz filespec .

İşlevler dosya bilgilerini içinde tanımlanan bir _finddata_t yapıda IO.hdöndürür. Ailedeki çeşitli işlevler yapı üzerinde _finddata_t birçok varyasyon kullanır. Temel _finddata_t yapı aşağıdaki öğeleri içerir:

unsigned attrib
Dosya özniteliği.

time_t time_create
Dosya oluşturma zamanı (-1L FAT dosya sistemleri için). Bu süre UTC biçiminde depolanır. Yerel saate dönüştürmek için kullanın localtime_s.

time_t time_access
Son dosya erişiminin zamanı (-1L FAT dosya sistemleri için). Bu süre UTC biçiminde depolanır. Yerel saate dönüştürmek için kullanın localtime_s.

time_t time_write
Dosyaya son yazma zamanı. Bu süre UTC biçiminde depolanır. Yerel saate dönüştürmek için kullanın localtime_s.

_fsize_t size
Dosyanın bayt cinsinden uzunluğu.

char name[ _MAX_PATH] NULL-yol olmadan eşleşen dosya veya dizinin sonlandırılan adı.

FAT sistemi gibi bir dosyanın oluşturulmasını ve son erişim zamanlarını desteklemeyen dosya sistemlerinde time_create ve time_access alanları her zaman -1Lolur.

_MAX_PATH 260 bayt olarak tanımlanır Stdlib.h .

Bulma işlemini sınırlamak için hedef öznitelikleri (örneğin _A_RDONLY) belirtemezsiniz. Bu öznitelikler, yapının alanında döndürülür attrib ve aşağıdaki değerlere sahip olabilir (içinde tanımlanmıştırIO.h)._finddata_t Kullanıcılar bu özniteliklerin alan için attrib mümkün olan tek değer olmasına güvenmemelidir.

_A_ARCH
Arşiv. Dosya her değiştirildiğinde ve komutu tarafından BACKUP temizlendiğinde ayarlayın. Değer: 0x20.

_A_HIDDEN
Gizli dosya. seçeneğini kullanmadığınız /AH sürece komutuyla DIR sık sık görülmez. Bu özniteliğe sahip normal dosyalar ve dosyalar hakkındaki bilgileri döndürür. Değer: 0x02.

_A_NORMAL
Normal. Dosyada başka öznitelik ayarlanmadı ve kısıtlama olmadan okunabilir veya yazılabilir. Değer: 0x00.

_A_RDONLY
Salt okunur. Dosya yazmak için açılamıyor ve aynı ada sahip bir dosya oluşturulamıyor. Değer: 0x01.

_A_SUBDIR
Altdizin. Değer: 0x10.

_A_SYSTEM
Sistem dosyası. veya /A:S seçeneği kullanılmadığı sürece /A normalde komutuyla DIR görülmez. Değer: 0x04.

_findnext, daha önceki bir çağrısında _findfirstbelirtilen bağımsız değişkenle filespec eşleşen bir sonraki adı (varsa) bulur. bağımsız değişkeni, fileinfo önceki çağrısı tarafından başlatılan bir yapıya _findfirstişaret etmelidir. Eşleşme bulunursa, fileinfo yapı içeriği daha önce açıklandığı gibi değiştirilir. Aksi takdirde, değişmeden bırakılır. _findclose belirtilen arama tutamacını kapatır ve hem hem de _findfirst _findnextiçin tüm ilişkili kaynakları serbest bırakır. Silme gibi değişiklik işlemleri, kendilerine geçirilen yolları oluşturan dizinlerde gerçekleştirilmeden önce veya _findnext tarafından _findfirst döndürülen tanıtıcının önce öğesine geçirilmesi _findclosegerekir.

İşlevleri iç içe _find yerleştirebilirsiniz. Örneğin, bir çağrısı _findfirst veya _findnext alt dizin olan dosyayı bulursa, veya _findnextiçin başka bir çağrıyla _findfirst yeni bir arama başlatılabilir.

_wfindfirst ve _wfindnext 'nin _findfirst _findnextgeniş karakterli sürümleridir. Geniş karakterli sürümlerin yapı bağımsız değişkeni, içinde ve içinde IO.h tanımlanan veri türüne Wchar.hsahiptir_wfinddata_t. Bu veri türünün alanları, veri türündeki alanlarla _finddata_t aynıdır, ancak _wfinddata_t name alanında türü yerine türündedir wchar_t char. Aksi takdirde ve _wfindfirst _wfindnext ile _findfirst _findnextaynı şekilde davranır.

_findfirst ve _findnext 64 bit zaman türünü kullanın. Eski 32 bit zaman türünü kullanmanız gerekiyorsa tanımlayabilirsiniz _USE_32BIT_TIME_T. Bu işlevlerin adlarında soneki olan 32 sürümleri 32 bit zaman türünü, soneki olanlar 64 ise 64 bit zaman türünü kullanır.

, _findnext32i64, _wfindfirst32i64ve _wfindnext32i64 işlevleri_findfirst32i64, 64 bit dosya uzunluklarını kullanıp döndürmeleri dışında, bu işlevlerin 32 bit zaman türü sürümleriyle aynı şekilde davranır. İşlevler _findfirst64i32, _findnext64i32, _wfindfirst64i32ve _wfindnext64i32 64 bit zaman türünü kullanır, ancak 32 bit dosya uzunluklarını kullanır. Bu işlevler, alanların zaman ve dosya boyutu için farklı türlere sahip olduğu türün uygun çeşitlemelerini _finddata_t kullanır.

_finddata_t aslında olarak değerlendirilen _finddata64i32_t (veya _finddata32_t tanımlanmışsa _USE_32BIT_TIME_T ) bir makrodur. Aşağıdaki tabloda üzerindeki _finddata_tçeşitlemeler özetlemektedir:

_fsize_t bir typedef for unsigned long (32 bit).

Örnek

// 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

Ayrıca bkz.

Sistem çağrıları