_findfirst, _wfindfirst
Fournissent des informations à propos de la première instance d'un nom de fichier correspond au fichier spécifié dans l'argument d' 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
);
Paramètres
filespec
Spécification du fichier cible (peut inclure des caractères génériques).fileinfo
Mémoire tampon informations sur le fichier.
Valeur de retour
En cas de réussite, _findfirst retourne un unique handle de recherche identifiant le fichier ou l'ensemble de fichiers répondant à la spécification d' filespec , qui peut être utilisée dans un appel suivant à _findnext ou à _findclose.Sinon, _findfirst retourne - 1 et définit errno l'une des valeurs suivantes.
EINVAL
paramètre non valide : filespec ou fileinfo était NULL.ou, le système d'exploitation est retourné une erreur inattendue.ENOENT
Spécification de fichier qui ne peut pas être mise en correspondance.ENOMEM
mémoire insuffisante.EINVAL
La spécification de nom valide de fichier ou le nom de fichier donné est supérieure MAX_PATH.
Pour plus d'informations sur ces éléments et d'autres codes de retour, consultez _doserrno, errno, _sys_errlist, et _sys_nerr.
Si un paramètre non valide est passé, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.
Notes
Vous devez appeler _findclose lorsque vous avez terminé avec _findfirst ou la fonction d' _findnext (ou toutes variantes).Cela libère les ressources utilisées par ces fonctions dans votre application.
les variations de ces fonctions qui ont le préfixe d' w sont des versions à caractères larges ; sinon, elles sont identiques aux fonctions codées sur un octet correspondantes.
Les variations de ces fonctions prennent en charge 32 bits ou des type d'heure 64 bits et les tailles de fichier 32 bits ou 64 bits.le premier suffixe numérique (32 ou 64) indique la taille du type de temps ; le deuxième suffixe est i32 ou i64, et indique si la taille du fichier est représentée sous la forme 32 bits ou entier 64 bits.Des informations concernant le lequel les versions prennent en charge 32 bits et des types d'heure 64 bits et les tailles de fichiers, consultez le tableau suivant.Le suffixe d' i32 ou d' i64 est omis si elle est identique à la taille du type de temps, ce _findfirst64 prend également en charge des longueurs 64 bits de fichier et _findfirst32 prend en charge uniquement des longueurs 32 bits de fichier.
Ces formes d'utilisation de fonctions différents de la structure d' _finddata_t pour le paramètre d' fileinfo .Pour plus d'informations sur la structure, consultez _find, fonctions de _wfind.
Les variations qui utilisent un type d'heure 64 bits permettent aux dates de fichier-création à exprimer via le 23h59 : 59, le 31 décembre, 3000, l'heure UTC.Les personnes qui utilisent des types d'heure 32 bits représentent des dates uniquement via le 19h14 : Le 7 janvier 18, 2038, l'heure UTC.Minuit, le 1er janvier 1970, correspond à la limite inférieure de la plage de dates pour toutes ces fonctions.
À moins que vous ayez une raison spécifique pour utiliser des versions qui spécifient la taille de temps explicitement, l'utilisation _findfirst ou _wfindfirst ou, si vous avez besoin Go de tailles de fichiers de support de supérieure à 3, utilisez _findfirsti64 ou _wfindfirsti64.toutes ces fonctions utilisent le type d'heure 64 bits.Dans les versions antérieures, ces fonctions ont utilisé un type d'heure 32 bits.S'il s'agit d'une modification avec rupture pour une application, vous pouvez définir _USE_32BIT_TIME_T pour rétablir le comportement précédent.Si _USE_32BIT_TIME_T est défini, _findfirst, _finfirsti64, et leurs versions correspondantes Unicode utilisent l'heure 32 bits.
Calculez des variations de type et de longueur de fichier du _findfirst
Fonctions |
_USE_32BIT_TIME_T a défini ? |
Le temps passé dans le type |
Type de longueur du fichier |
---|---|---|---|
_findfirst, _wfindfirst |
non défini |
64 bits |
32 bits |
_findfirst, _wfindfirst |
(défini par) |
32 bits |
32 bits |
_findfirst32, _wfindfirst32 |
non affecté par la définition de macro |
32 bits |
32 bits |
_findfirst64, _wfindfirst64 |
non affecté par la définition de macro |
64 bits |
64 bits |
_findfirsti64, _wfindfirsti64 |
non défini |
64 bits |
64 bits |
_findfirsti64, _wfindfirsti64 |
(défini par) |
32 bits |
64 bits |
_findfirst32i64, _wfindfirst32i64 |
non affecté par la définition de macro |
32 bits |
64 bits |
_findfirst64i32, _wfindfirst64i32 |
non affecté par la définition de macro |
64 bits |
32 bits |
mappages de routines de texte générique
routine de Tchar.h |
_UNICODE et _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_tfindfirst |
_findfirst |
_findfirst |
_wfindfirst |
_tfindfirst32 |
_findfirst32 |
_findfirst32 |
_wfindfirst32 |
_tfindfirst64 |
_findfirst64 |
_findfirst64 |
_wfindfirst64 |
_tfindfirsti64 |
_findfirsti64 |
_findfirsti64 |
_wfindfirsti64 |
_tfindfirst32i64 |
_findfirst32i64 |
_findfirst32i64 |
_wfindfirst32i64 |
_tfindfirst64i32 |
_findfirst64i32 |
_findfirst64i32 |
_wfindfirst64i32 |
Configuration requise
Fonction |
en-tête requis |
---|---|
_findfirst |
<io.h> |
_findfirst32 |
<io.h> |
_findfirst64 |
<io.h> |
_findfirsti64 |
<io.h> |
_findfirst32i64 |
<io.h> |
_findfirst64i32 |
<io.h> |
_wfindfirst |
<io.h> ou <wchar.h> |
_wfindfirst32 |
<io.h> ou <wchar.h> |
_wfindfirst64 |
<io.h> ou <wchar.h> |
_wfindfirsti64 |
<io.h> ou <wchar.h> |
_wfindfirst32i64 |
<io.h> ou <wchar.h> |
_wfindfirst64i32 |
<io.h> ou <wchar.h> |
Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.
Équivalent .NET Framework
System : : E/S : : DirectoryInfo : : GetFiles