Provided by: manpages-es_1.55-8_all bug

NOMBRE

       fpurge, __fpurge - vacía un flujo

SINOPSIS

       /* no soportada */
       #include <stdio.h>

       int fpurge(FILE *stream);

       /* soportada */
       #include <stdio.h>
       #include <stdio_ext.h>

       void  __fpurge(FILE *stream);

DESCRIPCIÓN

       La  función  fpurge() vacía los buffers del flujo dado.  Para flujos de
       salida esta función descarta toda salida  pendiente.   Para  flujos  de
       entrada  esta función descarta toda entrada leída del objeto subyacente
       pero que  no  ha  sido  obtenida  todavía  con  getc(3);  ésto  incluye
       cualquier  texto  devuelto  a  la  entrada  via ungetc(). Véase también
       fflush(3).

       La función __fpurge() hace lo mismo, pero sin devolver un valor.

VALOR DEVUELTO

       Si se completa con éxito fpurge() devuelve 0.  En  caso  de  error,  se
       devuelve -1 y se modifica errno con el valor apropiado.

ERRORES

       EBADF  stream no es un flujo abierto.

CONFORME A

       Estas  funciones  no  son estándares ni portables.  La función fpurge()
       fue introducida en BSD 4.4 y no está disponible bajo Linux.  La función
       __fpurge()  fue introducida en Solaris, y está presente en glibc 2.1.95
       y posteriores.

OBSERVACIONES

       Habitualmente es un fallo querer descartar buffers de entrada.

VÉASE TAMBIÉN

       fclean(3), fflush(3), setbuf(3), stdio_ext(3)

                               15 diciembre 2001                     FPURGE(3)