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.