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

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.

Zdroje