CKTIS / C
snprintf — oblikovanje z omejeno velikostjo medpomnilnika
snprintf zapisuje oblikovano besedilo v medpomnilnik z določeno kapaciteto. Z vrnjeno vrednostjo je mogoče zaznati krajšanje; kapaciteta vključuje zaključni ničelni znak.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int snprintf(char * restrict s, size_t n, const char * restrict format, ...);snprintf iz <stdio.h> oblikuje podatke v polje s. Pri n > 0 zapiše največ n - 1 znakov in zaključni \0. Navedi dejansko razpoložljivo kapaciteto medpomnilnika, ne velikosti kazalca.
Najprej preveri result < 0: negativna vrnjena vrednost pomeni napako pri kodiranju. Sicer vrnjena vrednost predstavlja zahtevano dolžino brez \0, (unsigned int)result >= n pa pomeni, da za celoten rezultat skupaj z \0 ni dovolj prostora. Vsako nenegativno vrednost tipa int je mogoče predstaviti s tipom unsigned int, implicitne pretvorbe pri tej primerjavi pa ohranijo obe vrednosti. Pretvorba vrnjene vrednosti v size_t pa lahko spremeni vrednost, večjo od SIZE_MAX, in tako prikrije krajšanje.
snprintf(NULL, 0, ...) ne zapiše ničesar in omogoča izračun dolžine. Tipi argumentov se morajo ujemati z obliko; kopiranje med prekrivajočimi se objekti povzroči nedefinirano vedenje.
Primeri
#include <stdio.h>
int main(void)
{
char buf[5];
int result = snprintf(buf, sizeof buf, "%s", "abcdef");
if (result < 0) {
puts("encoding error");
return 1;
}
printf("buffer: %s\nrequired: %d\n", buf, result);
if ((size_t)result >= sizeof buf) {
puts("truncated");
}
return 0;
}
Rezultat
buffer: abcd required: 6 truncated
Koda in navedeni izpis sta bila preverjena v izoliranem okolju. Pretvorba v `size_t` v tem primeru deluje, ker je vrnjeno vrednost `6` mogoče predstaviti s tem tipom. V splošnem uporabi zgoraj opisano primerjavo z `unsigned int`.