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.