fgets

Lit au plus 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 de fichier est atteinte. Si des octets sont lus et qu'aucune erreur ne survient, é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, positionne l'indicateur eof sur stream (voir feof() ). Ceci n'est considéré comme un échec que si aucun octet n'a été lu, 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é causé par une autre erreur, positionne l'indicateur d'erreur (voir ferror() ) sur stream . Le contenu du tableau pointé par str est indéterminé (il pourrait 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 le 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