Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

setbuf — configurar el almacenamiento en búfer de un flujo

`setbuf`, de `<stdio.h>`, solicita almacenamiento en búfer completo si `buf` no es `NULL`, o funcionamiento sin búfer si `buf` es `NULL`. La implementación puede usar el array proporcionado, pero no está obligada a hacerlo. La función no indica si se atendió la solicitud.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);

setbuf(stream, buf) solicita un modo de almacenamiento en búfer para un flujo abierto. Si buf no es NULL, solicita almacenamiento en búfer completo (_IOFBF) con un tamaño de BUFSIZ. La implementación puede usar el array proporcionado como búfer, pero no está obligada a hacerlo. Pasar NULL solicita el funcionamiento sin búfer (_IONBF).

Llame a esta función antes de realizar cualquier otra operación en el flujo; la única excepción es una llamada fallida a setvbuf. Si buf no es NULL, debe apuntar a un array modificable de al menos BUFSIZ bytes que siga existiendo hasta que se cierre el flujo. El contenido del array no está especificado.

La función devuelve void, por lo que no puede indicar si se atendió la solicitud. setvbuf devuelve un código de estado, permite elegir el tamaño del búfer y admite el almacenamiento en búfer por líneas (_IOLBF).

Ejemplos

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    static char buffer[BUFSIZ];
    setbuf(stdout, buffer);

    if (puts("Hello") == EOF) {
        return EXIT_FAILURE;
    }
    if (fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Resultado

Hello

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes