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.