printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

Статья
06/09/2015

Печатает форматированный результат в стандартный поток вывода. В этих версиях printf, _printf_l, wprintf, _wprintf_l усовершенствована безопасность, как описано в разделе Функции безопасности в CRT.

int printf_s(
   const char *format [,
   argument]... 
);
int _printf_s_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wprintf_s(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_s_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Параметры

format
Управление форматом.
argument
Необязательные аргументы.
locale
Используемый языковой стандарт.

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

Возвращает число напечатанных символов или отрицательное значение в случае ошибки.

Заметки

Функция printf_s форматирует и выводит ряд символов и значений в стандартный поток вывода, stdout. Если аргументы идут за строкой формата, то строка format должна содержать спецификации, которые определяют формат вывода для аргументов.

Основное различие между printf_s и printf заключается в том, что printf_s проверяет строку форматирования на наличие допустимых символов форматирования, тогда как printf только проверяет, является ли строка формата указателем null. Если проверка завершается с ошибкой, то вызывается обработчик недопустимого параметра, как описано в Проверка параметров. Если выполнение может быть продолжено, функция возвращает -1 и устанавливает errno в значение EINVAL.

Дополнительные сведения о errno и кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Поведение printf_sиfprintf_s идентичны за исключением того, что printf_s выводит данные в stdout, а не в место назначения типа FILE. Для получения дополнительной информации см. fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

wprintf_s — двухбайтовая версия printf_s; format — двухбайтовая строка. Поведение wprintf_s и printf_s идентично, если поток открыт в режиме ANSI-совместимости. printf_s в настоящее время не поддерживает вывод в поток в юникоде.

Версии этих функций с суффиксом _l идентичны за исключением того, что они используют переданный параметр языкового стандарта вместо языкового стандарта текущего потока.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_unicode определена
_tprintf_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

Аргумент format состоит из обычных символов, escape-последовательностей и (если аргументы следуют за параметром format) спецификаций формата. Обычные символы и escape-последовательности копируются в stdout в порядке их следования. Например, в строке

printf_s("Line one\n\t\tLine two\n");

создает выходные данные

Line one
        Line two

Спецификации формата всегда начинаются со знака процента (%) и читаются слева направо. При обнаружении printf_s первой спецификации формата (если таковые имеются) она преобразует значение первого аргумента после format и выводит его соответствующим образом. Вторая спецификация формата приводит к преобразованию и выводу второго аргумента и так далее. Если аргументов больше, чем спецификаций формата, дополнительные аргументы игнорируются. Результаты будут не определены, если аргументов недостаточно для всех спецификаций формата.

Примечание по безопасности
Убедитесь, что format не является строкой, определяемой пользователем.

Требования

Подпрограмма	Обязательный заголовок
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_l	<stdio.h> или <wchar.h>

Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_printf_s.c
/* This program uses the printf_s and wprintf_s functions
 * to produce formatted output.
 */

#include <stdio.h>

int main( void )
{
   char   ch = 'h', *string = "computer";
   int    count = -9234;
   double fp = 251.7366;
   wchar_t wch = L'w', *wstring = L"Unicode";

   /* Display integers. */
   printf_s( "Integer formats:\n"
           "   Decimal: %d  Justified: %.6d  Unsigned: %u\n",
           count, count, count );

   printf_s( "Decimal %d as:\n   Hex: %Xh  C hex: 0x%x  Octal: %o\n",
            count, count, count, count );

   /* Display in different radixes. */
   printf_s( "Digits 10 equal:\n   Hex: %i  Octal: %i  Decimal: %i\n",
            0x10, 010, 10 );

   /* Display characters. */

   printf_s("Characters in field (1):\n%10c%5hc%5C%5lc\n", ch, ch, wch, wch);
   wprintf_s(L"Characters in field (2):\n%10C%5hc%5c%5lc\n", ch, ch, wch, wch);

   /* Display strings. */

   printf_s("Strings in field (1):\n%25s\n%25.4hs\n   %S%25.3ls\n",
   string, string, wstring, wstring);
   wprintf_s(L"Strings in field (2):\n%25S\n%25.4hs\n   %s%25.3ls\n",
       string, string, wstring, wstring);

   /* Display real numbers. */
   printf_s( "Real numbers:\n   %f %.2f %e %E\n", fp, fp, fp, fp );

   /* Display pointer. */
   printf_s( "\nAddress as:   %p\n", &count);

}

Пример результатов выполнения

Integer formats:
   Decimal: -9234  Justified: -009234  Unsigned: 4294958062
Decimal -9234 as:
   Hex: FFFFDBEEh  C hex: 0xffffdbee  Octal: 37777755756
Digits 10 equal:
   Hex: 16  Octal: 8  Decimal: 10
Characters in field (1):
         h    h    w    w
Characters in field (2):
         h    h    w    w
Strings in field (1):
                 computer
                     comp
   Unicode                      Uni
Strings in field (2):
                 computer
                     comp
   Unicode                      Uni
Real numbers:
   251.736600 251.74 2.517366e+002 2.517366E+002

Address as:   0012FF78