Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

vfprintf — formatowanie wyjścia z va_list

vfprintf zapisuje sformatowane dane do strumienia FILE, pobierając argumenty z va_list zamiast z listy argumentów zmiennych.

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

Składnia

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

vfprintf działa jak fprintf, ale przyjmuje va_list. Nagłówki to <stdio.h> i <stdarg.h>; reguły formatowania pozostają takie same.

Zainicjalizuj listę przez va_start. Po wywołaniu nie używaj jej ponownie poza va_end; do niezależnego przejścia przygotuj wcześniej kopię przez va_copy i również zakończ ją przez va_end.

Wynik oznacza liczbę zapisanych znaków albo wartość ujemną przy błędzie wyjścia lub kodowania. Typy argumentów muszą odpowiadać formatowi; niezgodność powoduje niezdefiniowane zachowanie. Niezaufany tekst przekazuj przez %s, nie jako format.

Przykłady

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

static int write_message(FILE *stream, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vfprintf(stream, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = write_message(stdout, "%s: %d\n", "Items", 3);
    int flush_result = fflush(stdout);
    return count == 9 && flush_result == 0 ? EXIT_SUCCESS : EXIT_FAILURE;
}

Wynik

Items: 3

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

Źródła