CKTIS / C
vsprintf — oblikovanje v medpomnilnik z uporabo va_list
vsprintf zapisuje oblikovano besedilo v medpomnilnik, argumente pa pridobi iz va_list. Velikosti medpomnilnika ne prejme.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);vsprintf deluje kot sprintf, vendar namesto argumentov ... sprejme va_list. V s zapiše tudi zaključni ničelni znak.
Medpomnilnik mora sprejeti celoten rezultat skupaj z ničelnim znakom. Prekoračitev in kopiranje med prekrivajočimi se objekti povzročita nedefinirano vedenje. Vrste argumentov se morajo ujemati s specifikatorji formata. Nezaupanja vrednega besedila ne uporabljaj kot format; za omejitev zapisovanja izberi vsnprintf.
Seznam inicializiraj z va_start. Funkcija ne pokliče va_end: to naredi sam. Po klicu seznama ne beri znova. Če ga želiš neodvisno pregledati, predhodno pripravi kopijo z va_copy.
Vrnjena vrednost pove število zapisanih znakov brez zaključnega ničelnega znaka ali je ob napaki pri kodiranju negativna.
Primeri
#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;
}
Rezultat
score=7 7
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.