CKTIS / C
fgets — función de flujo de C23
`fgets(s, n, stream)` de `<stdio.h>` lee como máximo `n - 1` caracteres en el array `s`, deteniéndose después de leer un salto de línea o al terminar el archivo. El salto leído queda en el array y la función añade después `\0`.
Versión: C23
Sintaxis
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) de <stdio.h> lee como máximo n - 1 caracteres en el array s, deteniéndose después de leer un salto de línea o al terminar el archivo. El salto leído queda en el array y la función añade después \0.
El ejemplo escribe red\nblue en un tmpfile() y llama dos veces a fgets. 4 1 blue muestra que el primer búfer tiene cuatro caracteres e incluye \n, mientras el segundo lee la línea final sin salto terminador.
Devuelve s al tener éxito o null por error de lectura o si aparece EOF antes de leer un carácter; distingue los casos con feof y ferror. Pasa un n positivo que no supere la capacidad real ni el rango de int. Una línea larga puede requerir varias llamadas y un byte \0 incrustado impide que strlen describa todo lo leído.
Ejemplos
#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;
}
Resultado
4 1 blue
El ejemplo escribe `red\nblue` en un `tmpfile()` y llama dos veces a `fgets`. `4 1 blue` muestra que el primer búfer tiene cuatro caracteres e incluye `\n`, mientras el segundo lee la línea final sin salto terminador.