std::vprintf, std::vfprintf, std::vsprintf, std::vsnprintf

int vprintf( const char* format, std::va_list vlist );

int vfprintf( std::FILE* stream, const char* format, std::va_list vlist );

int vsprintf( char* buffer, const char* format, std::va_list vlist );

int vsnprintf( char* buffer, std::size_t buf_size, const char* format, std::va_list vlist );

Загружает данные из расположений, определённых vlist, преобразует их в эквиваленты строковых символов и записывает результаты в различные потоки.

Параметры

Строка format состоит из обычных байтовых символов (кроме %), которые копируются без изменений в выходной поток, и спецификаций преобразования. Каждая спецификация преобразования имеет следующий формат:

• вводящий символ %.
• (необязательно) один или несколько флагов, которые изменяют поведение преобразования:
• -: результат преобразования выравнивается слева внутри поля (по умолчанию выравнивание справа).
• +: знак знакового преобразования всегда добавляется перед результатом преобразования (по умолчанию перед результатом добавляется минус только если он отрицательный).
• пробел: если результат знакового преобразования не начинается со знака или пуст, пробел добавляется перед результатом. Он игнорируется, если присутствует флаг +.
• #: выполняется альтернативная форма преобразования. Смотрите таблицу ниже для точного эффекта, в противном случае поведение не определено.
• 0: для целых и чисел с плавающей точкой, ведущие нули используются для заполнения поля вместо символов пробел. Для целых чисел он игнорируется, если точность явно указана. Для других преобразований использование этого флага приводит к неопределенному поведению. Он игнорируется, если присутствует флаг -.
• (необязательно) целое значение или *, которые задают минимальную ширину поля. Результат дополняется символами пробел (по умолчанию), если необходимо, слева при правом выравнивании или справа при левом выравнивании. В случае использования *, ширина задаётся дополнительным аргументом типа int, который предшествует аргументу, подлежащему преобразованию, и аргументу, задающему точность, если она задана. Если значение аргумента отрицательное, это приводит к указанию флага - и положительной ширине поля (Примечание: Это минимальная ширина: значение никогда не обрезается).
• (необязательно) ., за которым следует целое число или *, или ничего, что задаёт точность преобразования. В случае использования *, точность задаётся дополнительным аргументом типа int, который предшествует аргументу, подлежащему преобразованию, но следует за аргументом, задающим минимальную ширину поля, если он задан. Если значение этого аргумента отрицательное, оно игнорируется. Если ни число, ни * не используются, точность принимается равной нулю. Смотрите таблицу ниже для точного эффекта точности.
• (необязательно) модификатор длины, который задаёт размер аргумента (в сочетании со спецификатором формата преобразования, он задаёт тип соответствующего аргумента).
• спецификатор формата преобразования.

Доступны следующие спецификаторы формата:

• если P > X ≥ −4, преобразование выполняется в стиле f или F с точностью P − 1 − X.
• в противном случае, преобразование выполняется в стиле e или E с точностью P − 1.

Если не запрашивается альтернативное представление, trailing zeros удаляются, а также десятичная точка удаляется, если дробная часть отсутствует. Для бесконечности и нечисловых значений см. примечания.

Функции преобразования с плавающей точкой преобразуют бесконечность в inf или infinity. Какой вариант используется, определяется реализацией.

Не-число преобразуется в nan или nan(char_sequence). Какой вариант используется, определяется реализацией.

Преобразования F, E, G, A выводят INF, INFINITY, NAN соответственно.

Несмотря на то, что %c ожидает int аргумент, безопасно передавать char, из-за повышения целых чисел, которое происходит при вызове функции с переменным числом аргументов.

Правильные спецификации преобразования для типов символов фиксированной ширины (int8_t, и т.д.) определены в заголовке <cinttypes> (хотя PRIdMAX, PRIuMAX, и т.д. является синонимом %jd, %ju, и т.д.).

Спецификатор преобразования для записи в память %n является распространённой целью эксплойтов, где строки формата зависят от входных данных пользователя, и не поддерживается семейством функций printf_s с проверкой границ.

После выполнения каждого спецификатора преобразования имеется точка последовательности; это позволяет хранить несколько результатов %n в одной переменной или, как частный случай, печатать строку, изменённую ранее %n в том же вызове.

Если спецификация преобразования некорректна, поведение не определено.

Возвращаемое значение

Примечания

Все эти функции вызывают va_arg по крайней мере один раз, значение arg неопределено после возврата. Эти функции не вызывают va_end, и это должно выполняться вызывающей стороной.

Пример

#include <cstdarg>
#include <cstdio>
#include <ctime>
#include <vector>
 
void debug_log(const char *fmt, ...)
{
    std::time_t t = std::time(nullptr);
    char time_buf[100];
    std::strftime(time_buf, sizeof time_buf, "%D %T", std::gmtime(&t));
    std::va_list args1;
    va_start(args1, fmt);
    std::va_list args2;
    va_copy(args2, args1);
    std::vector<char> buf(1 + std::vsnprintf(nullptr, 0, fmt, args1));
    va_end(args1);
    std::vsnprintf(buf.data(), buf.size(), fmt, args2);
    va_end(args2);
    std::printf("%s [debug]: %s\n", time_buf, buf.data());
}
 
int main()
{
    debug_log("Logging, %d, %d, %d", 1, 2, 3);
}

04/13/15 15:09:18 [debug]: Logging, 1, 2, 3

См. также