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

CKTIS / C

vfprintf — saída formatada a partir de va_list

vfprintf escreve dados formatados num fluxo FILE e recebe os argumentos de uma va_list, em vez de uma lista de argumentos variáveis.

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

Sintaxe

#include <stdarg.h>
#include <stdio.h>
int vfprintf(FILE * restrict stream, const char * restrict format, va_list arg);

vfprintf funciona como fprintf, mas aceita uma va_list. Os cabeçalhos necessários são <stdio.h> e <stdarg.h>; as regras de formatação mantêm-se.

Inicialize a lista com va_start. Após a chamada, não a volte a utilizar, exceto para va_end. Para um percurso independente, crie primeiro uma cópia com va_copy e termine também essa cópia com va_end.

O resultado é o número de caracteres escritos ou um valor negativo em caso de erro de saída ou de codificação. Os tipos dos argumentos têm de corresponder ao formato; as incompatibilidades causam comportamento indefinido. Passe texto não fiável através de %s, não como formato.

Exemplos

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

static int write_message(FILE *stream, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vfprintf(stream, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = write_message(stdout, "%s: %d\n", "Items", 3);
    int flush_result = fflush(stdout);
    return count == 9 && flush_result == 0 ? EXIT_SUCCESS : EXIT_FAILURE;
}

Resultado

Items: 3

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