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

CKTIS / C

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

vprintf записва форматиран текст в stdout, като използва аргументи от va_list. Позволява да се създават потребителски функции за извеждане, които приемат променлив брой аргументи.

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

Синтаксис

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

vprintf работи като printf, но приема va_list вместо аргументи, подадени чрез .... Записва в stdout; vfprintf позволява да изберете поток.

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

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

Върнатата стойност показва броя на изпратените знаци или е отрицателна при грешка при извеждане или кодиране. Примерът очаква 10, включително \n.

Примери

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

Резултат

Score: 42

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

Източници