fgets

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 ocurre el fin de 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 fallo.

Si se encuentra la condición de fin de archivo, establece el indicador eof en stream (ver feof() ). Esto solo constituye un fallo si provoca que no se lean bytes, en cuyo caso se retorna un puntero nulo y los contenidos del array apuntado por str no se alteran (es decir, el primer byte no se sobrescribe con un carácter nulo).

Si el fallo ha sido causado por algún otro error, establece el indicador de error (ver ferror() ) en stream . Los contenidos del array apuntado por str son indeterminados (puede que ni siquiera esté terminado en nulo).

Notas

POSIX adicionalmente 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 sí lo hacen

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

• algunas implementaciones no hacen nada, reportan error,
• otras no leen nada, almacenan cero en str [ 0 ] , reportan é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