Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje