fgets

char* fgets( char* str, int count, FILE* stream );

char* fgets( char* restrict str, int count, FILE* restrict stream );

Lee como máximo count - 1 caracteres del flujo de archivo dado y los almacena en el arreglo de caracteres apuntado por str. El análisis se detiene si se encuentra un carácter de nueva línea (en cuyo caso str contendrá ese carácter de nueva línea) o si se alcanza el final del archivo. Si se leen bytes y no ocurren errores, escribe un carácter nulo en la posición inmediatamente después del último carácter escrito en str.

Parámetros

Valor de retorno

str en caso de éxito, puntero nulo en caso de error.

Si se encuentra la condición de fin de archivo, establece el indicador eof en stream (véase feof()). Esto solo es un error si provoca que no se lean bytes, en cuyo caso se devuelve un puntero nulo y el contenido del arreglo apuntado por str no se modifica (es decir, el primer byte no se sobrescribe con un carácter nulo).

Si el error ha sido causado por otro error, establece el indicador error (véase ferror()) en stream. El contenido del arreglo apuntado por str es indeterminado (puede que ni siquiera tenga terminación nula).

Notas

POSIX además requiere que fgets establezca errno si ocurre un error de lectura.

Aunque la especificación estándar es poco clara en los casos donde count <= 1, las implementaciones comunes hacen

• si count < 1, no hacer nada, informar error,
• si count == 1,

• algunas implementaciones no hacen nada, informan error,
• otras no leen nada, almacenan cero en str[0], informan éxito.

Ejemplo

#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

Referencias

Véase también