fgets

char* fgets( char* str, int count, FILE* stream );

char* fgets( char* restrict str, int count, FILE* restrict stream );

Lit au maximum count - 1 caractères depuis le flux de fichier donné et les stocke dans le tableau de caractères pointé par str. L'analyse s'arrête si un caractère de nouvelle ligne est trouvé (auquel cas str contiendra ce caractère de nouvelle ligne) ou si la fin du fichier est atteinte. Si des octets sont lus et qu'aucune erreur ne se produit, écrit un caractère nul à la position immédiatement après le dernier caractère écrit dans str.

Paramètres

Valeur de retour

str en cas de succès, pointeur nul en cas d'échec.

Si la condition de fin de fichier est rencontrée, définit l'indicateur eof sur stream (voir feof()). Ce n'est un échec que si cela ne provoque la lecture d'aucun octet, auquel cas un pointeur nul est retourné et le contenu du tableau pointé par str n'est pas modifié (c'est-à-dire que le premier octet n'est pas écrasé par un caractère nul).

Si l'échec a été provoqué par une autre erreur, définit l'indicateur error (voir ferror()) sur stream. Le contenu du tableau pointé par str est indéterminé (il peut même ne pas être terminé par un caractère nul).

Notes

POSIX exige en outre que fgets définisse errno si une erreur de lecture se produit.

Bien que la spécification standard soit peu claire dans les cas où count <= 1, les implémentations courantes font

• si count < 1, ne rien faire, signaler une erreur,
• si count == 1,

• certaines implémentations ne font rien, signalent une erreur,
• d'autres ne lisent rien, stockent zéro dans str[0], signalent un succès.

Exemple

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    FILE* tmpf = tmpfile();
    fputs("Alan Turing\n", tmpf);
    fputs("John von Neumann\n", tmpf);
    fputs("Alonzo Church\n", tmpf);
 
    rewind(tmpf);
    
    char buf[8];
    while (fgets(buf, sizeof buf, tmpf) != NULL)
          printf("\"%s\"\n", buf);

    if (feof(tmpf))
       puts("End of file reached");
}

"Alan Tu"
"ring
"
"John vo"
"n Neuma"
"nn
"
"Alonzo "
"Church
"
End of file reached

Références

Voir aussi