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.