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

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.

Fontes