std::vwprintf, std::vfwprintf, std::vswprintf
Определён в заголовочном файле <cwchar> | ||
|---|---|---|
int vwprintf( const wchar_t* format, va_list vlist ); | (1) | |
int vfwprintf( std::FILE* stream, const wchar_t* format, va_list vlist ); | (2) | |
int vswprintf( wchar_t* buffer, std::size_t buf_size, const wchar_t* format, va_list vlist ); | (3) |
Загружает данные из мест, определённых vlist,, преобразует их в эквивалентные широкие строки и записывает результаты в различные назначения.
stdout.stream.buffer. Записывается не более size-1 широких символов, после которых следует нулевой широкий символ.Параметры
| stream | - | выходной широкий поток для записи |
| buffer | - | указатель на широкую строку для записи |
| buf_size | - | максимальное число широких символов для записи |
| format | - | указатель на широкую строку с завершающим нулевым символом, задающую способ интерпретации данных |
| vlist | - | список аргументов переменной длины, содержащий данные для вывода. |
Строка format состоит из обычных широких символов (кроме %), которые без изменений копируются в выходной поток, и спецификаций преобразования. Каждая спецификация преобразования имеет следующий формат:
- вводный символ
%. - (необязательно) один или несколько флагов, изменяющих поведение преобразования:
-
-: результат преобразования выравнивается по левому краю поля (по умолчанию — по правому). -
+: знак преобразования со знаком всегда добавляется перед результатом преобразования (по умолчанию перед результатом ставится знак минуса, только если он отрицательный). -
пробел: если результат преобразования со знаком не начинается со знака или является пустым, перед результатом добавляется пробел. Игнорируется, если присутствует флаг
+. -
#: выполняется преобразование в альтернативной форме. Точные эффекты см. в таблице ниже; в противном случае поведение не определено. -
0: при преобразовании целых чисел и чисел с плавающей точкой для заполнения поля используются нули в начале вместо символов пробела. Для целых чисел игнорируется, если точность задана явно. Использование этого флага для других преобразований приводит к неопределённому поведению. Игнорируется, если присутствует флаг-. -
(необязательно) целочисленное значение или
*, задающее минимальную ширину поля. При необходимости результат заполняется символами пробела (по умолчанию): слева при выравнивании по правому краю или справа при выравнивании по левому краю. Если используется*, ширина задаётся дополнительным аргументом типа int, который располагается перед преобразуемым аргументом и аргументом, задающим точность, если он указан. Если значение аргумента отрицательно, это равносильно указанию флага-и положительной ширины поля (Примечание: это минимальная ширина: значение никогда не усекается.). -
(необязательно)
., за которым следует целое число или*, либо ничего; задаёт точность преобразования. Если используется*, точность задаётся дополнительным аргументом типа int, который располагается перед преобразуемым аргументом, но после аргумента, задающего минимальную ширину поля, если он указан. Если значение этого аргумента отрицательно, оно игнорируется. Если не указано ни число, ни*, точность считается равной нулю. Точные эффекты точности см. в таблице ниже. - (необязательно) модификатор длины, задающий размер аргумента (в сочетании со спецификатором формата преобразования он задаёт тип соответствующего аргумента).
- спецификатор формата преобразования.
Доступны следующие спецификаторы формата:
| Спецификатор преобразования | Описание | Ожидаемый тип аргумента |
||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Модификатор длины→ | hh | h | нет | l | ll | j | z | t | L | |
| Доступно только начиная с C++11→ | Да | Да | Да | Да | Да | |||||
% | Записывает буквальный символ %. Спецификация преобразования целиком должна быть %%. | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д |
c | Записывает один символ.
| Н/Д | Н/Д |
int |
std::wint_t | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д |
s | Записывает строку символов.
| Н/Д | Н/Д |
char*
|
wchar_t*
| Н/Д | Н/Д | Н/Д | Н/Д | Н/Д |
di | Преобразует целое число со знаком в десятичное представление [-]dddd.
|
signedchar
|
short |
int |
long |
longlong
|
※ | Н/Д | ||
bB (необязательно) (C++26) | Преобразует беззнаковое целое число в двоичное представление bbbb.
|
unsignedchar
|
unsignedshort
|
unsignedint
|
unsignedlong
|
unsignedlonglong
|
беззнаковый вариант std::ptrdiff_t
| Н/Д | ||
o | Преобразует беззнаковое целое число в восьмеричное представление oooo.
| Н/Д | ||||||||
xX | Преобразует беззнаковое целое число в шестнадцатеричное представление hhhh.
| Н/Д | ||||||||
u | Преобразует беззнаковое целое число в десятичное представление dddd.
| Н/Д | ||||||||
fF (C++11) | Преобразует число с плавающей точкой в десятичную запись вида [-]ddd.ddd.
| Н/Д | Н/Д |
double |
double (C++11)
| Н/Д | Н/Д | Н/Д | Н/Д |
longdouble
|
eE | Преобразует число с плавающей точкой в десятичную экспоненциальную запись.
| Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | |||
aA (C++11) | Преобразует число с плавающей точкой в шестнадцатеричную экспоненциальную запись.
| Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | |||
gG | Преобразует число с плавающей точкой в десятичную или десятичную экспоненциальную запись в зависимости от значения и точности.
| Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | |||
n | Возвращает число символов, записанных этим вызовом функции на данный момент.
|
signedchar*
|
short*
|
int*
|
long*
|
longlong*
|
※ | Н/Д | ||
p | Записывает определяемую реализацией последовательность символов, представляющую указатель. | Н/Д | Н/Д |
void*
| Н/Д | Н/Д | Н/Д | Н/Д | Н/Д | Н/Д |
| Примечания | ||||||||||
| Функции преобразования чисел с плавающей точкой преобразуют бесконечность в Не-число преобразуется в Преобразования Спецификатор преобразования, используемый для вывода char, unsignedchar, signedchar, short и unsignedshort, ожидает типы, полученные в результате стандартных преобразований аргументов по умолчанию, однако перед выводом значение будет преобразовано в char, unsignedchar, signedchar, short и unsignedshort. Передавать значения этих типов безопасно благодаря повышению типа, выполняемому при вызове функции с переменным числом аргументов. Правильные спецификаторы преобразования для целочисленных типов фиксированной ширины ( Спецификатор преобразования После выполнения каждого спецификатора преобразования наступает точка последовательности; это позволяет сохранять несколько результатов Если спецификация преобразования некорректна, поведение не определено. |
||||||||||
Возвращаемое значение
size.Примечания
Для узких строк предусмотрено std::vsnprintf, позволяющее определить необходимый размер выходного буфера. Для широких строк эквивалента нет, поэтому для определения размера буфера программе может потребоваться вызвать std::vswprintf, проверить возвращаемое значение и выделить буфер большего размера, повторяя попытку до успеха.
Пример
См. также
|
(C++11) | выводит форматированные данные в stdout, файловый поток или буферс помощью списка аргументов переменной длины (функция) |
выводит форматированные данные с широкими символами в stdout, файловый поток или буфер (функция) |
|
Документация по C для vwprintf, vfwprintf, vswprintf |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/c/vfwprintf