_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