CKTIS / C
setbuf — configurar o armazenamento em buffer de um fluxo
`setbuf`, declarada em `<stdio.h>`, pede armazenamento em buffer completo se `buf` não for `NULL`, ou funcionamento sem buffer se `buf` for `NULL`. A implementação pode usar o array fornecido, mas não é obrigada a fazê-lo. A função não indica se o pedido foi satisfeito.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);setbuf(stream, buf) pede um modo de armazenamento em buffer para um fluxo aberto. Se buf não for NULL, pede armazenamento em buffer completo (_IOFBF) com o tamanho BUFSIZ. A implementação pode usar o array fornecido como buffer, mas não é obrigada a fazê-lo. Passar NULL pede o funcionamento sem buffer (_IONBF).
Chame a função antes de qualquer outra operação no fluxo; a única exceção é uma chamada a setvbuf que tenha falhado. Se buf não for NULL, tem de apontar para um array gravável com pelo menos BUFSIZ bytes, que continue a existir até ao fecho do fluxo. O conteúdo do array não é especificado.
A função devolve void, pelo que não pode indicar se o pedido foi satisfeito. setvbuf devolve um código de estado, permite escolher o tamanho do buffer e suporta o armazenamento em buffer por linhas (_IOLBF).
Exemplos
#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
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.