Поделиться через

_vcprintf_p, , _vcprintf_p_l_vcwprintf_p_vcwprintf_p_l

  • Статья

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

Внимание

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

Синтаксис

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   _locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_p_l(
   const wchar_t* format,
   _locale_t locale,
   va_list argptr
);

Параметры

format
Спецификация формата.

argptr
Указатель на список аргументов.

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

Дополнительные сведения см. в разделе "Синтаксис спецификации формата" printf и wprintf "Функции".

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

Число выведенных символов или отрицательное значение в случае ошибки. Если format имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжать, errno задано EINVALзначение -1 и возвращается значение -1.

Замечания

Каждая из этих функций принимает указатель на список аргументов, а затем использует функцию _putch для форматирования и записи данных в консоль. (_vcwprintf_p использует _putwch вместо _putch. _vcwprintf_p , является широкой версией символов _vcprintf_p. Она принимает строку с широким символом в качестве аргумента.)

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

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

Эти функции не переводят символы строкового канала в выходные данные в сочетаниях канала возврата каретки (CR-LF).

Внимание

Убедитесь, что format не является строкой, определяемой пользователем. Дополнительные сведения см. в разделе "Избегание переполнения буфера".

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

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

Подпрограмма Tchar.h _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_vtcprintf_p _vcprintf_p _vcprintf_p _vcwprintf_p
_vtcprintf_p_l _vcprintf_p_l _vcprintf_p_l _vcwprintf_p_l

Требования

Маршрут Обязательный заголовок
_vcprintf_p, _vcprintf_p_l <conio.h> и <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l <conio.h> и <stdarg.h>

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

Внимание

Начиная с 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_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
   va_list args;
   va_start(args, format);
   int result = _vcprintf_p(format, args);
   va_end(args);
   return result;
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

parameter 2 = 222; parameter 1 = one
38 characters printed

См. также

Консоль и порт ввода-вывода
_cprintf, , _cprintf_l_cwprintf_cwprintf_l
va_arg, , va_copyva_endva_start
Позиционные параметры printf_p