NOMBRE

       setbuf, setbuffer, setlinebuf, setvbuf - operaciones sobre búferes de flujos

SINOPSIS

       #include <stdio.h>

       void setbuf(FILE *flujo, char *buf);
       void setbuffer(FILE *flujo, char *buf, size_ttam);
       void setlinebuf(FILE *flujo);
       int setvbuf(FILE *flujo, char *buf, int modo , size_t tam);

DESCRIPCIÓN

       Los  tres  tipos  disponibles  de  estrategias de asignación de búferes son sin búfer, con
       búfer de bloque, y con búfer de línea. Cuando un  flujo  de  salida  está  sin  búfer,  la
       información  aparece en el fichero de destino o en la terminal tan pronto como se escribe;
       cuando está con búfer de bloque se guardan y escriben muchos caracteres  como  un  bloque;
       cuando está con búfer de línea los caracteres se van guardando hasta que se da un salto de
       línea o si la entrada se lee de cualquier flujo asociado  a  un  dispositivo  de  terminal
       (normalmente la entrada estándar stdin). Se puede emplear la función fflush(3) para forzar
       la escritura del bloque más pronto de la cuenta.  (Vea fclose(3).)  Normalmente todos  los
       ficheros  son de búfer de bloque. Cuando ocurre la primera operación de E/S en un fichero,
       se llama a malloc(3) y se obtiene un búfer. Si un flujo se refiere a  una  terminal  (como
       hace  normalmente  stdout)  es  de  búfer  de  línea. La salida estándar de errores stderr
       siempre es sin búfer por defecto.

       La función setvbuf puede emplearse en cualquier flujo abierto para cambiar su  búfer.   El
       parámetro modo debe ser una de las tres macros siguientes:

              _IONBF sin búfer

              _IOLBF búfer de línea

              _IOFBF búfer completo

       Salvo para ficheros sin búfer, el argumento buf debería apuntar a un búfer de al menos tam
       bytes de grande; este búfer se utilizará en lugar del actual. Si el argumento buf es NULL,
       sólo  el  modo  se  ve  afectado;  se obtendrá un nuevo búfer en la siguiente operación de
       lectura o escritura. La función setvbuf puede ser usada  solamente  después  de  abrir  un
       flujo y antes de que ninguna otra operación se haya realizado sobre él.

       Las  otras tres funciones son, en efecto, simplemente otras formas simplificadas de llamar
       a setvbuf.  La función setbuf es exactamente equivalente a la llamada

              setvbuf(flujo, buf, buf ? _IOFBF : _IONBF, BUFSIZ);

       La función setbuffer es lo mismo, excepto en  que  el  tamaño  del  búfer  se  deja  a  la
       discreción  del  usuario, en vez de estar determinado por el valor por omisión BUFSIZ.  La
       función setlinebuf es exactamente equivalente a la llamada:

              setvbuf(flujo, (char *)NULL, _IOLBF, 0);

VALOR DEVUELTO

       La función setvbuf devuelve 0 en caso de éxito.  Puede devolver cualquier valor si  falla,
       pero devuelve un valor distinto de cero cuando mode es inválido o la petición no puede ser
       atendida. Puede modificar errno en caso de fallo.  Las otras funciones no devuelven ningún
       valor.

CONFORME A

       Las funciones setbuf y setvbuf son conformes al estándar ANSI X3.159-1989 (``C ANSI'').

FALLOS

       Las funciones setbuffer y setlinebuf no son transportables a versiones de BSD anteriores a
       4.2BSD, y están disponibles bajo Linux desde libc 4.5.21. En  sistemas  4.2BSD  y  4.3BSD,
       setbuf siempre emplea un tamaño de búfer por debajo del óptimo, y debe ser evitada.

       Ud.  debe asegurarse de que tanto buf como el espacio al que apunte todavía existan cuando
       flujo se cierre, que también ocurre al acabarse el programa.

       Por ejemplo, lo siguiente está mal:

       #include <stdio.h>
       int main()
       {
           auto char buf[BUFSIZ];

           setbuf(stdin, buf);
           printf("¡Hola a todos!\n");
           return 0; /* Se destruye buf, se cierra stdin */
       }

SEE ALSO

       fclose(3), fflush(3), fopen(3), fread(3), malloc(3), printf(3), puts(3)