_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 строка форматирования содержит недопустимые символы форматирования, _printf_p а _wprintf_p функции вызывают обработчик недопустимых параметров, как описано в разделе проверки параметров.argument NULL Если выполнение может быть продолжено, функция возвращает -1 и устанавливает errno в значение EINVAL.

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

Требования

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

Пример

// 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