Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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`.

Viri