CKTIS / C
vprintf — formatowanie wyjścia z va_list
vprintf zapisuje sformatowany tekst do stdout, pobierając argumenty z va_list. Pozwala tworzyć własne funkcje wyjściowe ze zmienną liczbą argumentów.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);vprintf działa jak printf, lecz zamiast argumentów po ... przyjmuje va_list. Zapisuje do stdout; vfprintf pozwala wskazać strumień.
Listę zainicjalizuj przez va_start. Po wywołaniu nie używaj jej ponownie bez ponownej inicjalizacji; wykonaj va_end. Do niezależnego przejścia użyj wcześniej va_copy, a potem osobnego va_end.
Jeśli po przetworzeniu całego formatu zostaną argumenty, nadmiarowe argumenty są ignorowane. Zbyt mała liczba argumentów lub typ argumentu, który po domyślnych promocjach nie odpowiada typowi wymaganemu przez specyfikator konwersji, powodują niezdefiniowane zachowanie. Niezaufany tekst przekazuj jako dane dla %s, nie jako format.
Wynikiem jest liczba wysłanych znaków albo wartość ujemna przy błędzie wyjścia lub kodowania. Przykład oczekuje 10, wliczając \n.
Przykłady
#include <stdarg.h>
#include <stdio.h>
#include <stdlib.h>
static int print_message(const char *format, ...)
{
va_list args;
va_start(args, format);
int result = vprintf(format, args);
va_end(args);
return result;
}
int main(void)
{
int count = print_message("%s: %d\n", "Score", 42);
if (count != 10) {
return EXIT_FAILURE;
}
if (fflush(stdout) == EOF) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Wynik
Score: 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.