_find, _wfind funções

Essas funções Procurar e fechar procura nomes de arquivo especificado:

• _findnext, _wfindnext

• _findfirst, _wfindfirst

• _findclose

Comentários

The _findfirst função fornece informações sobre a primeira instância de um nome de arquivo que corresponda ao arquivo especificado na filespec argumento. Você pode usar em filespec qualquer combinação de caracteres curinga que é suportada pelo sistema operacional do host.

As funções retornam informações sobre o arquivo em um _ finddata_t estrutura, que é definida em IO.h. Várias funções da família usarem muitas variações no _finddata_t estrutura. O básico_finddata_t estrutura inclui os seguintes elementos:

• unsigned attrib
  Atributo de arquivo.

• time_t time_create
  time de criação do arquivo (–1L para sistemas de arquivos FAT).Essa time será armazenada no formato UTC.Para converter a time local, use localtime_s.

• time_t time_access
  time do último acesso de arquivo (–1L para sistemas de arquivos FAT).Essa time será armazenada no formato UTC.Para converter a time local, use localtime_s.

• time_t time_write
  time da última gravar ao arquivo.Essa time será armazenada no formato UTC.Para converter a time local, use localtime_s.

• _fsize_t size
  Comprimento do arquivo em bytes.

• char name[ _MAX_PATH]
  Terminada com caractere nulo nome de arquivo correspondente ou diretório, sem o caminho.

Em sistemas de arquivos que não suportam a criação e sistema autônomo horários dos últimos acessos de um arquivo, sistema autônomo o sistema FAT, o time_create e time_access campos sempre são –1L.

_MAX_PATH é definido no Stdlib.h sistema autônomo 260 bytes.

Não é possível especificar atributos de destino (sistema autônomo, por exemplo, _A_RDONLY) para limitar a operação de localização. Esses atributos são retornados no attrib campo de _finddata_t estruturar e pode ter os seguintes valores (definido na IO.h). Os usuários não devem depender esses sejam os únicos valores possíveis para o attrib campo.

• _A_ARCH
  arquivar.conjunto sempre que o arquivo é alterado e desmarcado, a BACKUP comando. Valor: 0 x 20.

• _A_HIDDEN
  Arquivo oculto.Não geralmente visto com o comando DIR, a menos que você use o /AH opção. Retorna informações sobre os arquivos normais e os arquivos que têm este atributo.Valor: 0 x 02.

• _A_NORMAL
  Normal.Arquivo não tenha outros atributos definido e podem leitura ou gravados para sem restrição.Valor: 0 x 00.

• _A_RDONLY
  Somente leitura.Arquivo não pode ser aberto para gravação e não pode ser criado um arquivo que tenha o mesmo nome.Valor: 0 x 01.

• _A_SUBDIR
  Subdiretório.Valor: 0 x 10.

• _A_SYSTEM
  Arquivo de sistema.Não é normalmente visto com o DIR comando, a menos que o /A ou /A:S opção é usada. Valor: 0x04.

_findnext Localiza o próximo nome, se houver, que corresponde a filespec argumento especificado em uma telefonar anterior a _findfirst. The fileinfo argumento deve apontar para uma estrutura inicializada por telefonar anterior _findfirst. Se uma correspondência for encontrada, a fileinfo estrutura de Sumário é alterada conforme descrito anteriormente. Caso contrário, ela é deixada inalterada._findclose Fecha o identificador de Pesquisar especificado e libera recursos todos os associados para ambos _findfirst e _findnext. O identificador retornado por um dos _findfirst ou _findnext primeiro deve ser passado para _findclose, antes de qualquer modificação, operações, tais sistema autônomo excluir, podem ser executadas em diretórios que formam sistema autônomo caminhos passados para eles.

Você pode aninhar o _find funções. Por exemplo, se uma telefonar para _findfirst ou _findnext Localiza o arquivo de um subdiretório, uma nova Pesquisar possa ser iniciado com outra telefonar para _findfirst ou _findnext.

_wfindfirst e _wfindnext são versões de caractere largo das _findfirst e _findnext. O argumento da estrutura das versões de caractere largo possui o _wfinddata_t tipo de dados, que é definido no IO.h e no Wchar.h. sistema autônomo campos deste tipo de dados são sistema autônomo mesmas do _finddata_t tipo de dados, exceto que, em _wfinddata_t o campo nome do campo é do tipo wchar_t em vez do tipo char. Caso contrário, _wfindfirst e _wfindnext se comportar de forma idêntica para _findfirst e _findnext.

In Visual C++ 2005, _findfirst e _findnext Use o tipo de time de 64 bit. Se você precisar usar o tipo de time de 32 bit antigo, você poderá definir _USE_32BIT_TIME_T. As versões dessas funções que têm o 32 sufixo em seus nomes usam o tipo de time de 32 bit e aqueles com o 64 sufixo usam o tipo de time de 64 bit.

Funções _findfirst32i64, _findnext32i64, _wfindfirst32i64, e _wfindnext32i64 também se comportam exatamente para as versões do tipo de time de 32 bit dessas funções, exceto usam e retornar os tamanhos de arquivo de 64 bit. Functions _findfirst64i32, _findnext64i32, _wfindfirst64i32, and _wfindnext64i32use the 64-bit time type but use 32-bit file lengths.Essas funções usarem variações apropriadas do _finddata_t tipo no qual os campos têm tipos diferentes para o tempo e o dimensionar do arquivo.

_finddata_t é realmente uma macro que é avaliada como _finddata64i32_t (ou _finddata32_t Se _USE_32BIT_TIME_T é definido). A tabela a seguir resume as variações no _finddata_t:

In Visual C++ 2005, _fsize_t é um typedef para unsigned long (32 bits).

Exemplo

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

Consulte também

Referência

Chamadas do sistema