std::vwprintf, std::vfwprintf, std::vswprintf

int vwprintf( const wchar_t* format, va_list vlist );

int vfwprintf( std::FILE* stream, const wchar_t* format, va_list vlist );

int vswprintf( wchar_t* buffer, std::size_t buf_size, const wchar_t* format, va_list vlist );

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

Параметры

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

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

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

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

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

Функции преобразования чисел с плавающей запятой преобразуют бесконечность в 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 в том же вызове.

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

Значение результата

Примечания

В то время как узкие строки предоставляют std::vsnprintf, что позволяет определить размер буфера вывода, нет эквивалента для широких строк, и для определения размера буфера программе может потребоваться вызвать std::vswprintf, проверить значение результата и перевыделить больший буфер, пытаясь снова до тех пор, пока это не удастся.

Пример

См. также