Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

vsprintf — formatowanie do bufora z użyciem va_list

vsprintf zapisuje sformatowany tekst do bufora, pobierając argumenty z va_list. Nie przyjmuje rozmiaru bufora.

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

Składnia

#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);

vsprintf działa jak sprintf, lecz przyjmuje va_list zamiast argumentów .... Zapisuje do s również końcowy znak zerowy.

Bufor musi pomieścić cały wynik i znak zerowy. Przepełnienie oraz kopiowanie między nakładającymi się obiektami powodują niezdefiniowane zachowanie. Typy argumentów muszą odpowiadać specyfikatorom formatu. Dla danych niezaufanych nie używaj ich treści jako format; do ograniczania zapisu wybierz vsnprintf.

Zainicjalizuj listę przez va_start. Funkcja nie wywołuje va_end: zrób to samodzielnie. Po wywołaniu nie odczytuj ponownie tej listy; do niezależnego przejścia przygotuj wcześniej kopię przez va_copy.

Wynik to liczba zapisanych znaków bez końcowego zera albo wartość ujemna przy błędzie kodowania.

Przykłady

#include <stdarg.h>
#include <stdio.h>

/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vsprintf(dst, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    char text[16];
    int count = format_text(text, "score=%d", 7);
    if (count < 0) {
        return 1;
    }
    puts(text);
    printf("%d\n", count);
    return 0;
}

Wynik

score=7
7

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

Źródła