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 :
- Cette fonction utilise l'interruption DOS (21h), fonction 4Eh afin de retourner le premier fichier à recherché.
| 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. |
Exemple
Voici un exemple montrant comment demander le nom du volume de l'unité de disque courant :
Voir également
Langage de programmation - Turbo C - Référence de fonctions - findnext
Dernière mise à jour : Samedi, le 4 juillet 2015