Section courante

A propos

Section administrative du site

FINDFIRST

Premier trouvé
Turbo C dir.h, dos.h

Syntaxe

int findfirst(char *nom_fich,struct ffblk *resul,int attr)

Paramètres

Nom Description
nom_fich Ce paramètre permet d'indiquer le nom du/des fichier(s) à rechercher. Si le chemin du/des fichier(s) a rechercher ne sont pas spécifié, il effectuera sa recherche dans le dossier courant. Lorsqu'on veut indiquer un groupe de fichiers, on utilisera les caractères génériques «?» (indique toutes les lettres ou chiffres) ou «*» (indique un groupe de lettres ou de chiffres).
attr Ce paramètre permet d'indiquer l'attribut de recherche :
Constante Valeur Description
FA_RDONLY 0x0001 Cette constante permet d'indiquer l'attribut de lecture seulement
FA_HIDDEN 0x0002 Cette constante permet d'indiquer l'attribut caché
FA_SYSTEM 0x0004 Cette constante permet d'indiquer l'attribut système
FA_LABEL 0x0008 Cette constante permet d'indiquer l'attribut de nom d'unité disque
FA_DIREC 0x0010 Cette constante permet d'indiquer l'attribut de nom de répertoire
FA_ARCH 0x0020 Cette constante permet d'indiquer l'attribut d'archive
resul Ce paramètre permet d'indiquer l'enregistrement contenant le résultat de la recherche. Voici la structure de l'enregistrement :
Champ Type de données Description
ff_reserved char [2] Ce champ permet d'indiquer des données réservés.
ff_attrib char Ce champ permet d'indiquer l'attribut du fichier.
ff_time unsigned Ce champ permet d'indiquer l'heure de la dernière mise à jour du fichier.
ff_fdate unsigned Ce champ permet d'indiquer la date de la dernière mise à jour du fichier.
ff_size long Ce champ permet d'indiquer la taille du fichier en octets.
ff_name char [13] Ce champ permet d'indiquer le nom du fichier.

Retour

Valeur Description
0 Cette valeur permet d'indiquer que l'opération a été un succès.
-1 Cette valeur permet d'indiquer qu'une erreur s'est produite et qu'il n'a pas été possible de lire le dossier. Dans ce cas, il sera possible d'obtenir des informations supplémentaires en consultant la variable errno.

Description

Cette fonction permet de recherche le premier occurrence (fichier ou répertoire) contenu dans un répertoire de fichier spécifier. Cependant, même si le fichier demandé existe, il les retournera uniquement s'il est compris dans le groupe d'attribut spécifié ainsi que dans les caractères génériques spécifiés.

Remarques

Exemple

Voici un exemple montrant comment demander le nom du volume de l'unité de disque courant :

  1. #include <dir.h>
  2. #include <dos.h>
  3.  
  4. int main() {
  5.  struct ffblk FileInfo;
  6.  if(findfirst("\*.*",&FileInfo,FA_LABEL) == 0) {
  7.    printf("Nom du volume = %s",FileInfo.ff_name);
  8.  } else {
  9.    puts("Nom de volume introuvable");
  10.  }
  11. }

Voir également

Langage de programmation - Turbo C - Référence de fonctions - findnext

Dernière mise à jour : Samedi, le 4 juillet 2015