_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

Записывают форматированные выходные данные в консоль с помощью указателя на список аргументов. Эти версии , _vcwprintf_l_vcprintf_l_vcwprintf имеют улучшения безопасности, как описано в функциях _vcprintfбезопасности в CRT.

Важно!

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

Синтаксис

int _vcprintf_s(
   char const* const format,
   va_list argptr
);
int _vcprintf_s_l(
   char const* const format,
   _locale_t locale,
   va_list argptr
);
int _vcwprintf_s(
   wchar_t const* const format,
   va_list argptr
);
int _vcwprintf_s_l(
   wchar_t const* const format,
   _locale_t locale,
   va_list argptr
);

Параметры

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

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

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

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

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

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

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

Замечания

Каждая из этих функций принимает указатель на список аргументов, а затем форматирует и записывает указанные данные в консоль. _vcwprintf_s — версия _vcprintf_s с расширенными символами. Она принимает строку расширенных символов в качестве аргумента.

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

Важно!

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

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

Подпрограмма TCHAR.H	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

Требования

Маршрут	Обязательный заголовок	Необязательные заголовки
_vcprintf_s, _vcprintf_s_l	<conio.h> и <stdarg.h>	<varargs.h>*
_vcwprintf_s, _vcwprintf_s_l	<conio.h> или <wchar.h и <stdarg.h>>	<varargs.h>*

* Требуется для совместимости UNIX V.

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

Важно!

Начиная с 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_s.cpp
#include <conio.h>
#include <stdarg.h>

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

int main()
{
    eprintf_s("(%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
              "<some error text>");
    eprintf_s("    (Related to symbol '%s' defined on line %d).\n",
              "<symbol>", 5 );
}

(10,23): Error C2111 : <some error text>
    (Related to symbol '<symbol>' defined on line 5).

См. также

Потоковый ввод-вывод
Функции vprintf
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, va_end, va_start