CKTIS / C
vfprintf — formátovaný výstup z va_list
vfprintf zapisuje formátovaná data do proudu FILE a přebírá argumenty z va_list místo ze seznamu proměnného počtu argumentů.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdarg.h>
#include <stdio.h>
int vfprintf(FILE * restrict stream, const char * restrict format, va_list arg);vfprintf funguje jako fprintf, ale přijímá va_list. Potřebné hlavičkové soubory jsou <stdio.h> a <stdarg.h>; pravidla formátování zůstávají stejná.
Seznam inicializujte pomocí va_start. Po volání jej znovu nepoužívejte, s výjimkou va_end. Pro nezávislý průchod nejprve vytvořte kopii pomocí va_copy a také tuto kopii ukončete pomocí va_end.
Výsledkem je počet zapsaných znaků nebo záporná hodnota při chybě výstupu či kódování. Typy argumentů musí odpovídat formátu; nesoulad způsobuje nedefinované chování. Nedůvěryhodný text předávejte přes %s, nikoli jako formát.
Příklady
#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;
}
Výsledek
Items: 3
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.