CKTIS / C
snprintf — formátovanie s obmedzenou veľkosťou buffera
snprintf zapisuje formátovaný text do buffera so zadanou kapacitou. Z návratovej hodnoty možno zistiť skrátenie; kapacita zahŕňa koncový nulový znak.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int snprintf(char * restrict s, size_t n, const char * restrict format, ...);snprintf z <stdio.h> formátuje údaje do poľa s. Pre n > 0 zapíše najviac n - 1 znakov a koncové \0. Uveď skutočnú dostupnú kapacitu buffera, nie veľkosť ukazovateľa.
Najprv skontroluj result < 0: záporná návratová hodnota označuje chybu kódovania. Inak návratová hodnota udáva požadovanú dĺžku bez \0 a (unsigned int)result >= n znamená, že na celý výsledok vrátane \0 nie je dosť miesta. Každú nezápornú hodnotu typu int možno vyjadriť v type unsigned int a implicitné konverzie pri tomto porovnaní zachovajú obe hodnoty. Konverzia návratovej hodnoty na size_t však môže zmeniť hodnotu väčšiu ako SIZE_MAX a zakryť tak skrátenie.
snprintf(NULL, 0, ...) nič nezapisuje a umožňuje vypočítať dĺžku. Typy argumentov musia zodpovedať formátu; kopírovanie medzi prekrývajúcimi sa objektmi má nedefinované správanie.
Príklady
#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;
}
Výsledok
buffer: abcd required: 6 truncated
Kód a uvedený výstup boli overené v izolovanom prostredí. Konverzia na `size_t` tu funguje, pretože návratovú hodnotu `6` možno v tomto type vyjadriť. Vo všeobecnosti použi porovnanie s `unsigned int` opísané vyššie.