Fonctions de la bibliothèque C -fscanf()
Bibliothèque standard C - <stdio.h>
Description
Fonctions de la bibliothèque Cint fscanf(FILE *stream, const char *format, ...)Lit une entrée formatée depuis le flux.
Déclaration
Voici la déclaration de la fonction fscanf().
int fscanf(FILE *stream, const char *format, ...)
Paramètre
- stream-- Il s'agit d'un pointeur vers un objet FILE qui identifie le flux.
- format-- Il s'agit d'une chaîne C qui contient un ou plusieurs des éléments suivants :caractères blancs, caractères non blancsetspécificateurs de format。
Le spécificateur de format prend la forme[=%[*][width][modifiers]type=], comme expliqué en détail ci-dessous :
| Paramètre | Description |
|---|---|
| * | Il s'agit d'un astérisque facultatif, indiquant que les données sont lues depuis le flux mais peuvent être ignorées, c'est-à-dire qu'elles ne sont pas stockées dans l'argument correspondant. |
| width | Ceci spécifie le nombre maximal de caractères à lire lors de l'opération de lecture en cours. |
| modificateurs | Spécifie une taille différente pour les données pointées par l'argument supplémentaire correspondant, autre que celle d'un entier (pour d, i et n), d'un entier non signé (pour o, u et x) ou d'un nombre à virgule flottante (pour e, f et g) : h : entier court (pour d, i et n), ou entier court non signé (pour o, u et x) l : entier long (pour d, i et n), ou entier long non signé (pour o, u et x), ou double (pour e, f et g) L : long double (pour e, f et g) |
| type | Un caractère qui spécifie le type de données à lire et la façon dont les données sont lues. Voir le tableau suivant pour plus de détails. |
Spécificateurs de type de fscanf :
| Type | Entrée qualifiante | type d'argument |
|---|---|---|
| c | Caractère unique : lit le caractère suivant. Si une largeur autre que 1 est spécifiée, la fonction lit un nombre de caractères égal à la largeur et les stocke dans les positions successives du tableau passé via l'argument. Aucun caractère nul n'est ajouté à la fin. | char * |
| d | Entier décimal : le signe + ou - avant le nombre est facultatif. | int * |
| e,E,f,g,G | Nombre à virgule flottante : contient un point décimal, un signe initial facultatif + ou -, un caractère final facultatif e ou E, et un chiffre décimal. Deux exemples valides sont -732.103 et 7.12e4 | float * |
| o | Entier octal. | int * |
| s | Chaîne de caractères. Lit les caractères successifs jusqu'à ce qu'un caractère d'espacement soit rencontré (les caractères d'espacement peuvent être des espaces, des retours à la ligne et des tabulations). | char * |
| u | Entier décimal non signé. | unsigned int * |
| x,X | Entier hexadécimal. | int * |
- Arguments supplémentaires-- Selon la chaîne de format, la fonction peut attendre une séquence d'arguments supplémentaires, chacun contenant une valeur à insérer, remplaçant chaque balise % spécifiée dans le paramètre format. Le nombre d'arguments doit être identique au nombre de balises %.
Valeur de retour
En cas de succès, la fonction renvoie le nombre d'éléments mis en correspondance et affectés avec succès. Si la fin du fichier est atteinte ou si une erreur de lecture se produit, elle renvoie EOF.
Exemple
L'exemple suivant montre l'utilisation de la fonction fscanf().
#include <stdio.h>
#include <stdlib.h>
int main()
{
char str1[10], str2[10], str3[10];
int year;
FILE * fp;
fp = fopen ("file.txt", "w+");
fputs("We are in 2014", fp);
rewind(fp);
fscanf(fp, "%s %s %s %d", str1, str2, str3, &year);
printf("Read String1 |%s|\n", str1 );
printf("Read String2 |%s|\n", str2 );
printf("Read String3 |%s|\n", str3 );
printf("Read Integer |%d|\n", year );
fclose(fp);
return(0);
}
Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :
Read String1 |We| Read String2 |are| Read String3 |in| Read Integer |2014|autres extensions