Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

vprintf — formátovaný výstup z va_list

vprintf zapisuje formátovaný text do stdout pomocí argumentů z va_list. Umožňuje vytvářet vlastní výstupní funkce, které přijímají proměnný počet argumentů.

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

Syntaxe

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

vprintf funguje jako printf, ale místo argumentů předávaných přes ... přijímá va_list. Zapisuje do stdout; vfprintf umožňuje zvolit proud.

Seznam inicializujte pomocí va_start. Po volání jej znovu nepoužívejte bez nové inicializace; zavolejte va_end. Pro nezávislý průchod nejprve použijte va_copy a potom samostatné va_end.

Pokud po zpracování celého formátu zbývají argumenty, přebytečné argumenty se ignorují. Chování je nedefinované, pokud je argumentů příliš málo nebo pokud typ některého argumentu po výchozích typových promocích neodpovídá typu požadovanému příslušnou specifikací konverze. Nedůvěryhodný text předávejte jako data pro %s, nikoli jako formát.

Návratová hodnota udává počet odeslaných znaků, případně je záporná při chybě výstupu nebo kódování. Příklad očekává 10 včetně \n.

Příklady

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

Výsledek

Score: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje