Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

snprintf — formatiranje uz ograničenje međuspremnika

snprintf zapisuje formatirani tekst u međuspremnik zadanog kapaciteta. Povratna vrijednost omogućuje otkrivanje skraćivanja; kapacitet uključuje završni nul-znak.

Verzija: 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> formatira podatke u polje s. Za n > 0 zapisuje najviše n - 1 znakova i završni \0. Navedi stvarni dostupni kapacitet međuspremnika, a ne veličinu pokazivača.

Najprije provjeri result < 0: negativna povratna vrijednost označava pogrešku kodiranja. Inače povratna vrijednost predstavlja potrebnu duljinu bez \0, a (unsigned int)result >= n znači da nema dovoljno prostora za cijeli rezultat, uključujući \0. Svaka nenegativna vrijednost tipa int može se prikazati tipom unsigned int, a implicitne pretvorbe pri toj usporedbi čuvaju obje vrijednosti. Pretvorba povratne vrijednosti u size_t može, naprotiv, promijeniti vrijednost veću od SIZE_MAX i tako prikriti skraćivanje.

snprintf(NULL, 0, ...) ne zapisuje ništa i omogućuje izračun duljine. Tipovi argumenata moraju odgovarati formatu; kopiranje između preklapajućih objekata ima nedefinirano ponašanje.

Primjeri

#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

Kôd i navedeni ispis provjereni su u izoliranom okruženju. Pretvorba u `size_t` ovdje funkcionira jer se povratna vrijednost `6` može prikazati tim tipom. Općenito upotrijebi gore opisanu usporedbu s tipom `unsigned int`.

Izvori