_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Статья
02/20/2013

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

int _scprintf_p(
   const char *format [,
   argument] ... 
);
int _scprintf_p_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_p _l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Параметры

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

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

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

Различие _scprintf_pи _scprintfзначение _scprintf_pподдерживает позиционных параметров, который позволяет определить порядок, в котором аргументы используются в строке формата.Дополнительные сведения см. в разделе позиционных параметров printf_p.

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

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Заметки

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

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