wprintf, fwprintf, swprintf, wprintf_s, fwprintf_s, swprintf_s, snwprintf_s

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

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

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

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

int swprintf( wchar_t *buffer, size_t bufsz,
              const wchar_t *format, ... );

int swprintf( wchar_t *restrict buffer, size_t bufsz,
              const wchar_t *restrict format, ... );

int wprintf_s( const wchar_t *restrict format, ... );

int fwprintf_s( FILE *restrict stream,
                const wchar_t *restrict format, ... );

int swprintf_s( wchar_t *restrict buffer, rsize_t bufsz,
                const wchar_t *restrict format, ... );

int snwprintf_s( wchar_t *restrict s, rsize_t n,
                 const wchar_t *restrict format, ... );

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

Примечания

Хотя узкие строки предоставляют snprintf, что позволяет определить необходимый размер буфера вывода, для широких строк нет эквивалента (до snwprintf_s)(с C11), и для определения размера буфера программе может потребоваться вызвать swprintf, проверить значение результата и перевыделить больший буфер, пытаясь снова до тех пор, пока не будет успеха.

snwprintf_s, в отличие от swprintf_s, будет усекать результат для соответствия массиву, на который указывает buffer, даже если усечение обрабатывается как ошибка большинством функций с проверкой границ.

Пример

#include <locale.h>
#include <wchar.h>
 
int main(void)
{
    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
    setlocale(LC_ALL, "en_US.utf8");
    swprintf(warr, sizeof warr/sizeof *warr,
              L"Converted from UTF-8: '%s'", narrow_str);
    wprintf(L"%ls\n", warr);
}

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

Ссылки

• Стандарт C11 (ISO/IEC 9899:2011):
• 7.29.2.1 Функция fwprintf (с. 403-410)
• 7.29.2.3 Функция swprintf (с. 416)
• 7.29.2.11 Функция wprintf (с. 421)
• K.3.9.1.1 Функция fwprintf_s (с. 628)
• K.3.9.1.4 Функция swprintf_s (с. 630-631)
• K.3.9.1.13 Функция wprintf_s (с. 637-638)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.24.2.1 Функция fwprintf (с. 349-356)
• 7.24.2.3 Функция swprintf (с. 362)
• 7.24.2.11 Функция wprintf (с. 366)

См. также