_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

Статья
06/09/2015

Возвращает число символов в форматированной строке.

int _scprintf(
   const char *format [,
   argument] ... 
);
int _scprintf_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf(
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Параметры

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

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

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

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

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

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

Заметки

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

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

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определены	_MBCS определено	_UNICODE определено
_sctprintf	_scprintf	_scprintf	_scwprintf
_sctprintf_l	_scprintf_l	_scprintf_l	_scwprintf_l

Требования

Подпрограмма	Обязательный заголовок
_scprintf, _scprintf_l	<stdio.h>
_scwprintf, _scwprintf_l	<stdio.h> или <wchar.h>

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

Пример

// crt__scprintf.c

#define _USE_MATH_DEFINES

#include <stdio.h>
#include <math.h>
#include <malloc.h>

int main( void )
{
   int count;
   int size;
   char *s = NULL;

   count = _scprintf( "The value of Pi is calculated to be %f.\n",
                      M_PI);

   size = count + 1; // the string will need one more char for the null terminator
   s = malloc(sizeof(char) * size);
   sprintf_s(s, size, "The value of Pi is calculated to be %f.\n",
                      M_PI);
   printf("The length of the following string will be %i.\n", count);
   printf("%s", s);
   free( s );
}