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