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

CKTIS / C

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

setvbuf selecciona el modo de almacenamiento en búfer de un flujo abierto antes de otras operaciones y permite proporcionar un búfer propio.

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

Sintaxis

#include <stdio.h>
int setvbuf(FILE * restrict stream, char * restrict buf, int mode, size_t size);

Llama a setvbuf de <stdio.h> después de abrir el flujo y antes de realizar cualquier otra operación sobre él; la excepción es una llamada fallida a setvbuf.

mode: _IOFBF — almacenamiento en búfer completo, _IOLBF — almacenamiento en búfer por líneas, _IONBF — sin almacenamiento en búfer. El valor de retorno 0 indica éxito; un valor distinto de cero indica un modo no válido o una solicitud que no se pudo satisfacer.

Si buf != NULL, size especifica el tamaño del array; la biblioteca puede utilizarlo. Mantenlo disponible hasta que se cierre el flujo; su contenido no está especificado. Si buf == NULL, la biblioteca puede utilizar size al asignar un búfer.

El ejemplo cierra stream antes de que deje de existir el buffer local. Salir del bloque sin cerrar el flujo causaría un comportamiento indefinido.

Ejemplos

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

int main(void)
{
    char buffer[BUFSIZ];
    FILE *stream = tmpfile();
    if (stream == NULL)
        return EXIT_FAILURE;

    if (setvbuf(stream, buffer, _IOFBF, sizeof buffer) != 0) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    int failed = fputs("Hello\n", stream) == EOF;
    if (fclose(stream) == EOF)
        failed = 1;
    if (failed)
        return EXIT_FAILURE;

    return puts("OK") == EOF ? EXIT_FAILURE : EXIT_SUCCESS;
}

Resultado

OK

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