Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

fgets — fonction de flux C23

`fgets(s, n, stream)` de `<stdio.h>` lit au plus `n - 1` caractères dans le tableau `s`, en s’arrêtant après un saut de ligne lu ou à la fin. Le saut de ligne reste dans le tableau et la fonction ajoute ensuite `\0`.

Version : C23

Syntaxe

char *fgets(char * restrict s, int n, FILE * restrict stream);

fgets(s, n, stream) de <stdio.h> lit au plus n - 1 caractères dans le tableau s, en s’arrêtant après un saut de ligne lu ou à la fin. Le saut de ligne reste dans le tableau et la fonction ajoute ensuite \0.

L’exemple écrit red\nblue dans un tmpfile() et appelle deux fois fgets. 4 1 blue montre que le premier tampon contient quatre caractères dont \n, tandis que le second lit la dernière ligne sans saut final.

Le retour est s en cas de succès ou null lors d’une erreur, ou si EOF survient avant tout caractère ; distinguez ces cas avec feof et ferror. Passez un n positif ne dépassant ni la capacité réelle ni int. Une longue ligne peut exiger plusieurs appels, et un octet \0 incorporé rend strlen insuffisant pour décrire toute la lecture.

Exemples

#include <stdio.h>
#include <string.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("red\nblue", stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    char first[8];
    char second[8];
    if (fgets(first, sizeof first, stream) == NULL || fgets(second, sizeof second, stream) == NULL) {
        fclose(stream);
        return 1;
    }
    printf("%zu %d %s\n", strlen(first), strchr(first, '\n') != NULL, second);
    return fclose(stream) == 0 ? 0 : 1;
}

Résultat

4 1 blue

L’exemple écrit `red\nblue` dans un `tmpfile()` et appelle deux fois `fgets`. `4 1 blue` montre que le premier tampon contient quatre caractères dont `\n`, tandis que le second lit la dernière ligne sans saut final.

Sources