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

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

Si vous souhaitez obtenir le reste de la liste des fichiers d'un dossier, vous devrez utiliser la fonction «findnext» afin de compléter votre recherche.
Les codes d'erreurs retournés par la variable «errno» correspondent généralement à ceci :

Constante	Description
ENMFILE	Cette constante permet d'indiquer que tous les fichiers du dossier ont été lus.
ENOENT	Cette constante permet d'indiquer qu'une composante du chemin n'existe pas ou que le chemin est une chaine de caractères vide.

Cette fonction utilise l'interruption DOS (21h), fonction 4Eh afin de retourner le premier fichier à recherché.

Exemple

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



#include <dir.h>

#include <dos.h>

 
int main() {

 struct ffblk FileInfo;

 if(findfirst("\*.*",&FileInfo,FA_LABEL) == 0) {

   printf("Nom du volume = %s",FileInfo.ff_name);

 } else {

   puts("Nom de volume introuvable");

 }

}

Voir également

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

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

Section courante

A propos

Section administrative du site

FINDFIRST