_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Статья
02/20/2013

Возвращает число символов в форматируемой строке, используя указатель на список аргументов.

int _vscprintf(
   const char *format,
   va_list argptr 
);
int _vscprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Параметры

format
Строка Формат-элемента управления.
argptr
Указатель на список аргументов.
locale
Языковой стандарт, который необходимо использовать.

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

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

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

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

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

Заметки

Каждое argument (если таковые имеются) в соответствии с соответствующим спецификации преобразования формата in format.Формат состоящая из обычных символов и имеет те же форму, как и функции format аргумент printf.

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