Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

setvbuf — configurar o buffering de um fluxo

setvbuf seleciona o modo de buffering de um fluxo aberto antes de outras operações e permite fornecer um buffer próprio.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

Chame setvbuf de <stdio.h> depois de abrir o fluxo e antes de qualquer outra operação sobre ele; uma chamada a setvbuf sem sucesso é a exceção.

mode: _IOFBF — buffering completo, _IOLBF — buffering por linhas, _IONBF — sem buffering. O valor devolvido 0 significa sucesso; um valor diferente de zero indica um modo inválido ou um pedido que não foi satisfeito.

Se buf != NULL, size especifica o tamanho do array; a biblioteca pode utilizar esse array. Mantenha-o válido até fechar o fluxo; o seu conteúdo não é especificado. Se buf == NULL, a biblioteca pode utilizar size ao alocar um buffer.

O exemplo fecha stream antes de o buffer local deixar de existir. Sair do bloco sem fechar o fluxo causaria comportamento indefinido.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes