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

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.

Fontes