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

CKTIS / C

Constantes de buffering de stdio

As macros de <stdio.h> selecionam o modo de buffering de um fluxo e indicam o tamanho do buffer para setbuf. Não parta do princípio de que têm valores numéricos específicos.

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);
void setbuf(FILE * restrict stream, char * restrict buf);

_IOFBF seleciona o buffering completo, _IOLBF o buffering por linhas e _IONBF a ausência de buffering. São argumentos mode de setvbuf. BUFSIZ indica o tamanho do buffer para setbuf, tem um valor mínimo de 256 e não é um modo.

O buffering completo prevê transferências em blocos quando o buffer fica cheio; o buffering por linhas também quando ocorre \n; os fluxos sem buffering transferem os dados assim que possível. Os detalhes dependem da implementação. fflush envia a saída pendente para o ambiente, sem garantir o seu armazenamento permanente em disco.

Chame setvbuf depois de abrir o fluxo e antes de outras operações, exceto depois de uma chamada sem sucesso a setvbuf. Zero significa sucesso. O array fornecido tem de permanecer disponível enquanto o fluxo o utilizar. setbuf(stream, buf) seleciona _IOFBF e BUFSIZ; setbuf(stream, NULL) seleciona _IONBF, sem comunicar erros.

Exemplos

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

int main(void)
{
    static char buffer[BUFSIZ];

    if (setvbuf(stdout, buffer, _IOFBF, sizeof buffer) != 0)
        return EXIT_FAILURE;
    if (fputs("Buffered output\n", stdout) == EOF)
        return EXIT_FAILURE;
    if (fflush(stdout) == EOF)
        return EXIT_FAILURE;
    return EXIT_SUCCESS;
}

Resultado

Buffered output

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