Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

sprintf — formatowanie tekstu do bufora

sprintf zapisuje sformatowany tekst do tablicy char. Nie przyjmuje rozmiaru bufora: miejsce musi wystarczyć także na końcowe '\0'.

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

Składnia

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

sprintf z <stdio.h> zapisuje do s, zamiast do strumienia. format określa konwersje: %s oczekuje łańcucha, %d wartości int, a %% zapisuje %. Niezgodne typy argumentów powodują niezdefiniowane zachowanie.

Wynik kończy się znakiem '\0'. Funkcja zwraca liczbę zapisanych znaków bez terminatora albo wartość ujemną przy błędzie kodowania.

Za mały bufor i kopiowanie między nakładającymi się obiektami powodują niezdefiniowane zachowanie. Sprawdzenie wyniku nie zapobiega przepełnieniu. snprintf przyjmuje limit rozmiaru i pozwala wykryć obcięcie wyniku.

Przykłady

#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;
}

Wynik

x=42
count=4

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła