_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Статья
06/09/2015

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

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
Используемый языковой стандарт.

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

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

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

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

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

Заметки

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

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

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определены	_MBCS определено	_UNICODE определено
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Требования

Подпрограмма	Обязательный заголовок
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> или <wchar.h>

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

См. также

Ссылки

Потоковый ввод-вывод

_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Поделиться через