_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Форматирует и производит вывод на консоль, поддерживает позиционные параметры в строке форматирования.

Важно!

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

int _cprintf_p(
   const char * format [,
   argument] ...
);
int _cprintf_p_l(
   const char * format,
   _locale_t locale [,
   argument] ...
);
int _cwprintf_p(
   const wchar * format [,
   argument] ...
);
int _cwprintf_p_l(
   const wchar * format,
   _locale_t locale [,
   argument] ...
);

Параметры

format
Строка управления форматом.

argument
Дополнительные параметры.

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

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

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

Замечания

Эти функции форматируют и выводят последовательности символов и значений напрямую на консоль, используя функции _putch и _putwch для вывода символов. Каждый argument (если он есть) преобразуется и выводится согласно соответствующей спецификацией формата в format. Формат имеет ту же форму и функцию, что format и параметр для printf_p функции. Различие между функциями _cprintf_p и cprintf_s заключается в том, что функция _cprintf_p поддерживает позиционные параметры, позволяющие определить порядок, в котором аргументы используются в строке форматирования. Дополнительные сведения см. в разделе Позиционные параметры printf_p.

fprintf_pprintf_pВ отличие от функций и sprintf_p функций, _cprintf_p и _cwprintf_p не преобразуйте символы строкового канала в сочетания возвращаемой строки каретки (CR-LF) при выходе. Важное отличие заключается в том, что функция _cwprintf_p показывает символы Юникода при использовании в Windows NT. В отличие от функции _cprintf_p, функция _cwprintf_p использует текущие параметры языкового стандарта консоли.

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

Кроме того, как и функции _cprintf_s и _cwprintf_s, они проверяют входной указатель и строку форматирования. argumentNULLЕсли format строка форматирования содержит недопустимые символы форматирования, эти функции вызывают обработчик недопустимых параметров, как описано в разделе проверки параметров. Если разрешается продолжать выполнение, эти функции возвращают -1 и задают errno значение EINVAL.

Важно!

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

Начиная с 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ссылкой.

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

Требования

Маршрут	Обязательный заголовок
_cprintf_p, _cprintf_p_l	<conio.h>
_cwprintf_p, _cwprintf_p_l	<conio.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate
    // \n as standard output does. Use \r\n instead.
    _cprintf_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n",
                h, i, u, c, s );
}

-16  001d  62511  A Test

См. также

Консоль и порт ввода-вывода
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l
_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
Позиционные параметры printf_p
Синтаксис спецификации форматирования: printf и wprintf функции