Langage de programmation - C++ - Référence de procédures et de fonctions

FGETS	Demande une chaîne dans un fichier
Langage C++	cstdio (stdio.h)

Syntaxe

char *fgets(char *str,int n,FILE *ptrfichier);

Paramètres

Nom	Description
ptrfichier	Ce paramètre permet d'indiquer l'identificateur de fichier
n	Ce paramètre permet d'indiquer le nombre de caractères maximal pouvant être lu
str	Ce paramètre permet d'indiquer la chaîne de caractères recevant les données

Description

Cette fonction effectue la lecture d'une chaîne de caractères dans un fichier.

Remarques

La fonction fgets() lit jusqu'à n-1 caractères du flux de données et les place dans le tableau de caractères pointé par str. Les caractères sont lus jusqu'à ce qu'une nouvelle ligne ou un EOF soit reçu ou jusqu'à ce que la limite spécifiée soit atteinte. Une fois les caractères lus, un null est placé dans le tableau immédiatement après la lecture du dernier caractère. Un caractère de nouvelle ligne sera conservé et fera partie du tableau pointé par str.
En cas de succès, la fonction fgets() renvoie str; un pointeur null est retourné en cas d'échec. Si une erreur de lecture se produit, le contenu du tableau pointé par str est indéterminé.
Étant donné qu'un pointeur null sera retourné lorsqu'une erreur s'est produite ou lorsque la fin du fichier est atteinte, vous devez utiliser feof() ou ferror() pour déterminer ce qui s'est réellement produit.

Exemple

Prenons pour acquis que le fichier «readtext.txt» est le contenu :

Un Deux Trois Quatre Cinq Six Sept Huit Neuf Dix Onze Douze Treize Quatorze Quinze Seize

Voici un exemple montrant une utilisation plus classique de cette fonction :

Essayer maintenant !



#include <iostream>

#include <cstdio>

#include <cstdlib>

 

int main()

{

    FILE * Handle = fopen("readtext.txt", "r");


    if(Handle != NULL) {

        char Temp[255];


        int I;

        for(I = 1; I <= 16; I++) {


            fgets(Temp,255,Handle);

            std::cout << I << ":" << Temp;


        }

        fclose(Handle);

    }

    return 0;


}

on obtiendra le résultat suivant :

1:Un 2:Deux 3:Trois 4:Quatre 5:Cinq 6:Six 7:Sept 8:Huit 9:Neuf 10:Dix 11:Onze 12:Douze 13:Treize 14:Quatorze 15:Quinze 16:Seize

Voir également

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 731.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 99.

Dernière mise à jour : Lundi, le 3 août 2015

Section courante

A propos

Section administrative du site

FGETS