Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

sprintf — formátování textu do bufferu

sprintf zapisuje formátovaný text do pole char. Nepřijímá velikost bufferu: místo musí stačit také na závěrečné '\0'.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdio.h>
int sprintf(char * restrict s, const char * restrict format, ...);

sprintf z <stdio.h> zapisuje do s, nikoli do proudu. format určuje konverze: %s očekává řetězec, %d hodnotu typu int a %% zapíše %. Neshodné typy argumentů způsobují nedefinované chování.

Výstup končí znakem '\0'. Funkce vrací počet zapsaných znaků bez tohoto ukončovacího znaku, nebo zápornou hodnotu při chybě kódování.

Příliš malý buffer a kopírování mezi překrývajícími se objekty způsobují nedefinované chování. Kontrola návratové hodnoty nezabrání přetečení. snprintf přijímá limit velikosti a umožňuje zjistit zkrácení výstupu.

Příklady

#include <stdio.h>

int main(void)
{
    char buffer[16];
    int count = sprintf(buffer, "%s=%d", "x", 42);
    if (count < 0) {
        return 1;
    }
    printf("%s\ncount=%d\n", buffer, count);
    return 0;
}

Výsledek

x=42
count=4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje