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)