CKTIS / C
vsprintf — oblikovanje u međuspremnik pomoću va_list
vsprintf zapisuje oblikovani tekst u međuspremnik, a argumente dohvaća iz va_list. Ne prima veličinu međuspremnika.
Verzija: 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 radi kao sprintf, ali prihvaća va_list umjesto argumenata .... U s zapisuje i završni nulti znak.
Međuspremnik mora moći pohraniti cijeli rezultat i nulti znak. Prekoračenje i kopiranje između preklapajućih objekata uzrokuju nedefinirano ponašanje. Vrste argumenata moraju odgovarati specifikatorima formata. Ne koristi nepouzdan tekst kao format; odaberi vsnprintf za ograničavanje zapisivanja.
Inicijaliziraj popis pomoću va_start. Funkcija ne poziva va_end: učini to sam. Nakon poziva nemoj ponovno čitati popis. Ako ga želiš neovisno prolaziti, unaprijed pripremi kopiju pomoću va_copy.
Povratna vrijednost označava broj zapisanih znakova bez završnog nultog znaka ili je negativna u slučaju pogreške kodiranja.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.