CKTIS / C
vsnprintf — oblikovanje va_list v omejen medpomnilnik
vsnprintf oblikuje argumente, podane prek va_list. Zapis omeji na zmogljivost medpomnilnika, vrnjena dolžina pa omogoča zaznati skrajšan izpis.
Različica: 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 deluje kot snprintf, vendar namesto argumentov ... sprejme va_list. Uporablja se za izdelavo lastnih funkcij za oblikovanje.
n je zmogljivost medpomnilnika v bajtih, vključno s končnim \0. Pri n > 0 zapiše največ n - 1 bajtov izpisa in zaključni znak. Pri n == 0 ne zapiše ničesar; s je lahko NULL.
Rezultat r je potrebna dolžina brez zaključnega znaka; negativna vrednost pomeni napako pri kodiranju. Najprej preverite r < 0. Če je r nenegativen in velja n > 0, pogoj (unsigned int)r >= n pomeni, da je izpis skrajšan. Pretvorba v unsigned int ohrani vsako nenegativno vrednost tipa int, tudi če je s tipom size_t ni mogoče predstaviti.
Seznam inicializirajte z va_start in ga zaključite z va_end; funkcija tega ne stori namesto vas. Za nov prehod uporabite va_copy, preden seznam porabite, in zaključite tudi kopijo. Vrste argumentov se morajo ujemati z obliko; prekrivajoči se kopirani objekti povzročijo nedefinirano vedenje. Nezaupanja vredno besedilo podajte kot podatek za %s, ne kot obliko.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.