CKTIS / C
vprintf — formátovaný výstup z va_list
vprintf zapisuje formátovaný text do stdout pomocou argumentov z va_list. Umožňuje vytvárať vlastné výstupné funkcie, ktoré prijímajú premenlivý počet argumentov.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);vprintf funguje ako printf, ale namiesto argumentov odovzdávaných cez ... prijíma va_list. Zapisuje do stdout; vfprintf umožňuje vybrať prúd.
Zoznam inicializujte pomocou va_start. Po volaní ho znova nepoužívajte bez opätovnej inicializácie; zavolajte va_end. Ak potrebujete nezávislý priechod, najprv použite va_copy a potom samostatné va_end.
Ak po spracovaní celého formátu zostanú argumenty, prebytočné argumenty sa ignorujú. Správanie je nedefinované, ak je argumentov primálo alebo ak typ niektorého argumentu po predvolených typových povýšeniach nezodpovedá typu, ktorý vyžaduje príslušná špecifikácia konverzie. Nedôveryhodný text odovzdávajte ako údaje pre %s, nie ako formát.
Návratová hodnota udáva počet odoslaných znakov alebo je záporná pri chybe výstupu či kódovania. Príklad očakáva 10 vrátane \n.
Prí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ýsledok
Score: 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.