CKTIS / C
vprintf — saída formatada a partir de uma va_list
vprintf escreve texto formatado em stdout usando os argumentos de uma va_list. Permite criar funções de saída personalizadas que aceitam um número variável de argumentos.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);vprintf funciona como printf, mas aceita uma va_list em vez de argumentos através de .... Escreve em stdout; vfprintf permite escolher um fluxo.
Inicialize a lista com va_start. Depois da chamada, não a reutilize sem a inicializar novamente; chame va_end. Para uma passagem independente, use primeiro va_copy e, em seguida, um va_end separado.
Se ainda houver argumentos depois de processar todo o formato, os argumentos em excesso são ignorados. O comportamento é indefinido se faltarem argumentos ou se o tipo de um argumento, após as promoções de argumentos predefinidas, não corresponder ao tipo exigido pela respetiva especificação de conversão. Passe texto não fiável como dado para %s, não como formato.
O valor devolvido indica o número de caracteres transmitidos ou é negativo em caso de erro de saída ou de codificação. O exemplo espera 10, incluindo \n.
Exemplos
#include <stdarg.h>
#include <stdio.h>
#include <stdlib.h>
static int print_message(const char *format, ...)
{
va_list args;
va_start(args, format);
int result = vprintf(format, args);
va_end(args);
return result;
}
int main(void)
{
int count = print_message("%s: %d\n", "Score", 42);
if (count != 10) {
return EXIT_FAILURE;
}
if (fflush(stdout) == EOF) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Resultado
Score: 42
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.