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

CKTIS / C

vsprintf — formatar para um buffer usando va_list

vsprintf escreve texto formatado num buffer e obtém os argumentos a partir de uma va_list. Não recebe o tamanho do buffer.

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

Sintaxe

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

vsprintf funciona como sprintf, mas aceita uma va_list em vez de argumentos .... Também escreve em s um carácter nulo de terminação.

O buffer tem de conseguir conter o resultado completo e o carácter nulo. Um transbordamento e a cópia entre objetos sobrepostos provocam comportamento indefinido. Os tipos dos argumentos têm de corresponder aos especificadores de formato. Não uses texto não fiável como format; escolhe vsnprintf para limitar as escritas.

Inicializa a lista com va_start. A função não chama va_end: fá-lo tu. Não voltes a ler a lista depois da chamada. Para a percorrer de forma independente, prepara previamente uma cópia com va_copy.

O valor devolvido indica o número de caracteres escritos, sem contar o carácter terminador, ou é negativo em caso de erro de codificação.

Exemplos

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

/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vsprintf(dst, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    char text[16];
    int count = format_text(text, "score=%d", 7);
    if (count < 0) {
        return 1;
    }
    puts(text);
    printf("%d\n", count);
    return 0;
}

Resultado

score=7
7

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