_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Статья
04/10/2013

Write форматировало результат на консоль с помощью указателя в список аргументов.Более безопасные версии этих функций, доступных в разделе _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

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

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

Параметры

format
Спецификация формата.
argptr
Указатель на список аргументов.
locale
Используемый языковой стандарт.

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

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

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

Заметки

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

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

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

Универсальное текстовое сопоставление функций

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Требования

Функция	Требуемый заголовок	Необязательные заголовки
_vcprintf, _vcprintf_l	<conio.h> и <stdarg.h>	<varargs.h>*
_vcwprintf, _vcwprintf_l	<conio.h> или <wchar.h>и <stdarg.h>	<varargs.h>*

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

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

Пример

// crt_vcprintf.cpp
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf(format, args);
}

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