База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

vfprintf — форматиран изход от va_list

vfprintf записва форматирани данни в поток FILE и получава аргументите от va_list, а не от списък с променлив брой аргументи.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

vfprintf работи като fprintf, но приема va_list. Необходимите заглавни файлове са <stdio.h> и <stdarg.h>; правилата за форматиране остават същите.

Инициализирайте списъка с va_start. След извикването не го използвайте отново, освен за va_end. За независимо обхождане първо създайте копие с va_copy и завършете и това копие с va_end.

Резултатът е броят записани символи или отрицателна стойност при грешка на изхода или кодирането. Типовете на аргументите трябва да съответстват на формата; несъответствията водят до недефинирано поведение. Подавайте ненадежден текст чрез %s, а не като формат.

Примери

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

Резултат

Items: 3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници