_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Статья
06/09/2015

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

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 возвращает число символов, которое будет обработано, если строка, указанная в списке аргументов, была бы напечатана или отправлена в файл или буфер с помощью указанных кодов форматирования. Возвращаемое значение не включает завершающий символ null. _vscwprintf выполняет ту же функцию для расширенных символов.

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

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

Заметки

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

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