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.