NOMBRE

       fgetc, fgets, getc, getchar, gets, ungetc - entrada de caracteres y cadenas de ellos

SINOPSIS

       #include <stdio.h>

       int fgetc(FILE *flujo);
       char *fgets(char *s, int tam, FILE *flujo);
       int getc(FILE *flujo);
       int getchar(void);
       char *gets(char *s);
       int ungetc(int c, FILE *flujo);

DESCRIPCIÓN

       fgetc()  lee el siguiente carácter de flujo y lo devuelve como un unsigned char modelado a
       un int, o EOF al llegar al final del flujo o en caso de error.

       getc() es equivalente a fgetc() excepto en el hecho de que puede estar  implementado  como
       una macro que evalúe flujo más de una vez.

       getchar() es equivalente a getc(stdin).

       gets()  lee  una  línea  de  stdin  y  la  guarda en el búfer al que apunta s hasta que se
       encuentre bien un carácter terminador nueva-línea, bien EOF, al cual reemplaza  con  '\0'.
       No se hace ninguna comprobación de desbordamiento del búfer (vea FALLOS más abajo).

       fgets()  lee  como mucho uno menos de tam caracteres del flujo y los guarda en el búfer al
       que apunte s.  La lectura se para tras un EOF o una nueva-línea.  Si  se  lee  una  nueva-
       línea, se guarda en el búfer. Tras el último carácter en el búfer se guarda un '\0'.

       ungetc()  pone c de vuelta en flujo, modelado a unsigned char, donde queda disponible para
       una posterior operación de lectura. Los caracteres puestos en el flujo serán devueltos  en
       orden inverso; sólo se garantiza que se pueda devolver al flujo un carácter.

       Las llamadas a las funciones descritas aquí pueden mezclarse unas con otras y con llamadas
       a otras funciones de entrada de la biblioteca stdio para el mismo flujo de entrada.

       Para las versiones no-bloqueantes, véase unlocked_stdio(3).

VALOR DEVUELTO

       fgetc(), getc() y getchar() devuelven el carácter leído como un unsigned char  modelado  a
       un int o EOF al llegar al final de la entrada o en caso de error.

       gets()  y fgets() devuelven s en caso de éxito, y NULL en caso de error o cuando se llegue
       al final del fichero mientras que no se haya leído ningún carácter.

       ungetc() devuelve c en caso de éxito, o EOF en caso de error.

CONFORME A

       ANSI - C, POSIX.1

FALLOS

       No use nunca gets().  Puesto que es imposible saber, sin conocer de  antemano  los  datos,
       cuántos  caracteres  va a leer gets(), y puesto que gets() continuará guardando caracteres
       una vez alcanzado el final del búfer, su empleo es extremadamente peligroso. Muchas  veces
       ha  sido utilizado para comprometer la seguridad de un sistema. En su lugar emplee fgets()
       siempre que pueda.

       No es recomendable mezclar llamadas a las funciones de entrada de la biblioteca stdio  con
       llamadas  de  bajo  nivel  a read() para el descriptor de fichero asociado con el flujo de
       entrada; los resultados serán indefinidos y probablemente no los deseados.

VÉASE TAMBIÉN

       read(2),  write(2),  ferror(3),   fopen(3),   fread(3),   fseek(3),   puts(3),   scanf(3),
       unlocked_stdio(3)