setbuf

void setbuf( FILE* stream, char* buffer );

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

Establece el búfer interno que se usará para las operaciones de flujo. Debe tener al menos BUFSIZ caracteres de longitud.

Si buffer no es nulo, equivale a setvbuf(stream, buffer, _IOFBF, BUFSIZ).

Si buffer es nulo, equivale a setvbuf(stream, NULL, _IONBF, 0), lo que desactiva el almacenamiento en búfer.

Parámetros

Notas

Si BUFSIZ no es el tamaño de búfer apropiado, setvbuf se puede usar para cambiarlo.

setvbuf también se debe usar para detectar errores, ya que setbuf no indica éxito o fracaso.

Esta función solo se puede usar después de que stream se haya asociado con un archivo abierto, pero antes de cualquier otra operación (que no sea una llamada fallida a setbuf/setvbuf).

Un error común es configurar el búfer de stdin o stdout a un arreglo cuyo tiempo de vida termina antes de que el programa finalice:

int main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

Ejemplo

#include <stdio.h>
#include <threads.h>

int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){ .tv_sec = 1 }, NULL); // sleep 1 sec
    putchar('b');
}

ab

Referencias

Véase también