std::wprintf, std::fwprintf, std::swprintf

int wprintf( const wchar_t* format, ... );

int fwprintf( std::FILE* stream, const wchar_t* format, ... );

int swprintf( wchar_t* buffer, std::size_t size, const wchar_t* format, ... );

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

Параметры

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

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

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

Функции преобразования чисел с плавающей точкой преобразуют бесконечность в 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::snprintf, что позволяет определить необходимый размер буфера вывода, для широких строк эквивалента нет, и для определения размера буфера программа может потребовать вызвать std::swprintf, проверить значение результата и перевыделить больший буфер, повторяя попытку до тех пор, пока не добьётся успеха.

Пример

#include <clocale>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    char narrow_str[] = "z\u00df\u6c34\U0001f34c";
                  // or "zß水🍌";
                  // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t warr[29]; // the expected string is 28 characters plus 1 null terminator
    std::setlocale(LC_ALL, "en_US.utf8");
 
    std::swprintf(warr, sizeof warr/sizeof *warr,
                  L"Converted from UTF-8: '%s'", narrow_str);
 
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << warr << '\n';
}

Converted from UTF-8: 'zß水🍌'

См. также