_printf_p, , _printf_p_l_wprintf_p_wprintf_p_l

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

Синтаксис

int _printf_p(
   const char *format [,
   argument]...
);
int _printf_p_l(
   const char *format,
   _locale_t locale [,
   argument]...
);
int _wprintf_p(
   const wchar_t *format [,
   argument]...
);
int _wprintf_p_l(
   const wchar_t *format,
   _locale_t locale [,
   argument]...
);

Параметры

format
Формат объекта.

argument
Необязательные аргументы.

locale
Используемый языковой стандарт.

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

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

Замечания

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

Различие между функциями _printf_p и printf_s заключается в том, что функция _printf_p поддерживает позиционные параметры, позволяющие определить порядок, в котором аргументы используются в строке форматирования. Дополнительные сведения см. в разделе Позиционные параметры printf_p.

Функция _wprintf_p является версией функции _printf_p для расширенных символов; они ведут себя одинаково, если поток открыт в режиме ANSI. Функция _printf_p на данный момент не поддерживает вывод данных в поток в кодировке Юникод.

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

Внимание

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

Значение , если format строка форматирования содержит недопустимые символы форматирования, _printf_p а _wprintf_p функции вызывают обработчик недопустимых параметров, как описано в разделе проверки параметров.argument NULL Если выполнение может быть продолжено, функция возвращает -1 и устанавливает errno в значение EINVAL.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tprintf_p	_printf_p	_printf_p	_wprintf_p
_tprintf_p_l	_printf_p_l	_printf_p_l	_wprintf_p_l

Требования

Маршрут	Обязательный заголовок
_printf_p, _printf_p_l	<stdio.h>
_wprintf_p, _wprintf_p_l	<stdio.h> или <wchar.h>

Консоль не поддерживается в приложениях универсальная платформа Windows (UWP). Стандартные дескрипторы потока, связанные с консолью, stdinstdoutи stderr, должны быть перенаправлены перед тем, как функции времени выполнения C могут использовать их в приложениях UWP. Дополнительные сведения о совместимости см. в разделе Совместимость.

Внимание

Начиная с Windows 10 версии 2004 (сборка 19041), printf семейство функций выводит точно представленные числа с плавающей запятой в соответствии с правилами IEEE 754 для округления. В предыдущих версиях Windows точно представленные числа с плавающей запятой, заканчивающиеся на "5", всегда округлялись. IEEE 754 утверждает, что они должны округлиться до ближайшей даже цифры (также известной как "Округление банкира"). Например, оба printf("%1.0f", 1.5) и printf("%1.0f", 2.5) должны округлиться до 2. Ранее 1,5 округляет до 2 и 2,5 округления до 3. Это изменение влияет только на точно представленные числа. Например, 2.35 (который при представлении в памяти приближается к 2,3500000000000000008) продолжает округляется до 2,4. Округление, выполняемое этими функциями, теперь также учитывает режим округления с плавающей запятой, заданный fesetround. Ранее округление всегда выбрало FE_TONEAREST поведение. Это изменение влияет только на программы, созданные с помощью Visual Studio 2019 версии 16.2 и более поздних версий. Чтобы использовать устаревшее поведение округления с плавающей запятой, свяжите со legacy_stdio_float_rounding.objссылкой.

Пример

// crt_printf_p.c
// This program uses the _printf_p and _wprintf_p
// functions to choose the order in which parameters
// are used.

#include <stdio.h>

int main( void )
{
   // Positional arguments
   _printf_p( "Specifying the order: %2$s %3$s %1$s %4$s %5$s.\n",
              "little", "I'm", "a", "tea", "pot");

   // Resume arguments
   _wprintf_p( L"Reusing arguments: %1$d %1$d %1$d %1$d\n", 10);

   // Width argument
   _printf_p("Width specifiers: %1$*2$s", "Hello\n", 10);
}

Specifying the order: I'm a little tea pot.
Reusing arguments: 10 10 10 10
Width specifiers:     Hello

См. также

Поддержка математических и плавающих точек
Потоковый ввод-вывод
Локаль
fopen, _wfopen
_fprintf_p, , _fprintf_p_l_fwprintf_p_fwprintf_p_l
fprintf, , _fprintf_lfwprintf_fwprintf_l
fprintf_s, , _fprintf_s_lfwprintf_s_fwprintf_s_l
scanf, , _scanf_lwscanf_wscanf_l
scanf_s, , _scanf_s_lwscanf_s_wscanf_s_l
_sprintf_p, , _sprintf_p_l_swprintf_p_swprintf_p_l
sprintf, , _sprintf_lswprintf, _swprintf_l__swprintf_l
sprintf_s, , _sprintf_s_lswprintf_s_swprintf_s_l
Функции vprintf