_vscprintf_p, , _vscprintf_p_l_vscwprintf_p_vscwprintf_p_l

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

Синтаксис

int _vscprintf_p(
   const char *format,
   va_list argptr
);
int _vscprintf_p_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr
);
int _vscwprintf_p_l(
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

Параметры

format
Строка управления форматом.

argptr
Указатель на список аргументов.

locale
Используемый языковой стандарт.

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

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

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

Замечания

Эти функции отличаются от _vscprintf и _vscwprintf только тем, что они поддерживают возможность указать порядок, в котором используются аргументы. Дополнительные сведения см. в разделе printf_p "Позиционные параметры".

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

Возвращаемое значение — это размер отформатированных данных. Если функция принимает буфер char, размер находится в байтах. Если функция принимает буфер wchar_t, размер указывает количество 16-разрядных слов. Символы относятся к char символам функций, которые принимают буфер char, а также wchar_t символы для функций, которые принимают буфер wchar_t.

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

Внимание

Если параметр format является определяемой пользователем строкой, убедитесь, что она содержат завершающий нуль-символ и имеет правильное количество и тип параметров. Дополнительные сведения см. в разделе "Избегание переполнения буфера". Начиная с Windows 10 версии 2004 (сборка 19041), printf семейство функций выводит точно представленные числа с плавающей запятой в соответствии с правилами IEEE 754 для округления. В предыдущих версиях Windows точно представленные числа с плавающей запятой, заканчивающиеся на "5", всегда округлялись. IEEE 754 утверждает, что они должны округлиться до ближайшей даже цифры (также известной как "Округление банкира"). Например, оба printf("%1.0f", 1.5) и printf("%1.0f", 2.5) должны округлиться до 2. Ранее 1,5 округляет до 2 и 2,5 округления до 3. Это изменение влияет только на точно представленные числа. Например, 2.35 (который при представлении в памяти приближается к 2,3500000000000000008) продолжает округляется до 2,4. Округление, выполняемое этими функциями, теперь также учитывает режим округления с плавающей запятой, заданный fesetround. Ранее округление всегда выбрало FE_TONEAREST поведение. Это изменение влияет только на программы, созданные с помощью Visual Studio 2019 версии 16.2 и более поздних версий. Чтобы использовать устаревшее поведение округления с плавающей запятой, свяжите со legacy_stdio_float_rounding.objссылкой.

Сопоставления подпрограмм универсального текста

Подпрограмма TCHAR.H _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_vsctprintf_p _vscprintf_p _vscprintf_p _vscwprintf_p
_vsctprintf_p_l _vscprintf_p_l _vscprintf_p_l _vscwprintf_p_l

Требования

Маршрут Обязательный заголовок
_vscprintf_p, _vscprintf_p_l <stdio.h>
_vscwprintf_p, _vscwprintf_p_l <stdio.h> или <wchar.h>

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

Пример

Пример см. в примере vsprintf.

См. также

Функции vprintf
_scprintf_p, , _scprintf_p_l_scwprintf_p_scwprintf_p_l
_vscprintf, , _vscprintf_l_vscwprintf_vscwprintf_l

  • Last updated on