CKTIS / C
vsnprintf — formatiranje va_list u ograničeni međuspremnik
vsnprintf formatira argumente predane putem va_list. Ograničava zapis na kapacitet međuspremnika, a vraćena duljina omogućuje otkrivanje skraćenog izlaza.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdarg.h>
#include <stdio.h>
int vsnprintf(char * restrict s, size_t n, const char * restrict format, va_list arg);vsnprintf radi kao snprintf, ali prihvaća va_list umjesto argumenata .... Koristi se za izradu vlastitih funkcija za formatiranje.
n je kapacitet međuspremnika u bajtovima, uključujući završni \0. Za n > 0 zapisuje najviše n - 1 bajtova izlaza i završni znak. Za n == 0 ne zapisuje ništa; s može biti NULL.
Rezultat r predstavlja potrebnu duljinu bez završnog znaka; negativna vrijednost označava pogrešku kodiranja. Najprije provjerite r < 0. Ako je r nenegativan i vrijedi n > 0, uvjet (unsigned int)r >= n znači da je izlaz skraćen. Pretvorba u unsigned int čuva svaku nenegativnu vrijednost tipa int, čak i ako je size_t ne može prikazati.
Popis inicijalizirajte pomoću va_start i završite pomoću va_end; funkcija ne obavlja ovo drugo. Za sljedeći prolaz upotrijebite va_copy prije nego što potrošite popis i završite i kopiju. Vrste argumenata moraju odgovarati formatu; preklapajući kopirani objekti uzrokuju nedefinirano ponašanje. Nepouzdan tekst predajte kao podatak za %s, a ne kao format.
Primjeri
#include <stdarg.h>
#include <stdio.h>
static int format_to(char *dst, size_t cap, const char *fmt, ...)
{
va_list args;
va_start(args, fmt);
int result = vsnprintf(dst, cap, fmt, args);
va_end(args);
return result;
}
int main(void)
{
char buf[8];
int result = format_to(buf, sizeof buf, "%s:%d", "item", 12345);
if (result < 0) {
return 1;
}
printf("text=%s\nneeded=%d\ntruncated=%d\n",
buf, result, (unsigned int)result >= sizeof buf);
return 0;
}Rezultat
text=item:12 needed=10 truncated=1
Nakon provjere je li `result` negativan, primjer pretvara nenegativnu vrijednost u `unsigned int` i uspoređuje je s kapacitetom međuspremnika. Potrebno je 10 bajtova bez završnog znaka, pa se u međuspremnik kapaciteta 8 bajtova zapisuje samo `item:12` sa završnim znakom.