Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes