Функции vprintf

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

Заметки

Функции vprintf аналогичны эквивалентным им функциям, указанным в приведенной ниже таблице. Однако каждая функция vprintf принимает указатель на список аргументов, в то время как каждая из функций-аналогов принимает список аргументов.

Эти функции форматируют данные для вывода в местоназначение следующим образом.

Аргумент argptr имеет тип va_list, который определен в VARARGS.H и STDARG.H. Переменная argptr должна быть инициализирована va_start, и может быть повторно инициализирована последующими вызовами va_arg; argptr затем указывает на начало списка аргументов, которые конвертируются и передаются на выход в соответствии со спецификациями в аргументе format. format имеет ту же форму и функцию, как и аргумента format для printf. Ни одна из этих функций не вызывает va_end. Более полное описание каждой функции vprintf смотрите в описании ее функции-аналога, как показано в приведенной выше таблице.

_vsnprintf отличается от vsprintf тем, что она записывает не более чем count байтов в buffer.

Версии этих функций с инфиксом w в имени являются версиями с многобайтовыми символами соответствующих функций без инфикса w; в каждой из этих функций с многобайтовыми символами buffer и format являются строками многобайтовых символов. В противном случае каждая функция с многобайтовыми символами работает так же, как ее функция-аналог со строками однобайтовых символов.

Версии этих функций с суффиксами _s и _p являются более безопасными. Эти версии проверяют строки форматирования и создают исключение, если строка форматирования сформирована неправильно (например, если используются недопустимые символы форматирования).

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

Для vsprintf, vswprintf, _vsnprintf и _vsnwprintf, для копирования, происходящего между строками, которые перекрываются, поведение не определено.

Примечание по безопасности
Убедитесь, что format не является строкой, определяемой пользователем.Дополнительные сведения см. в разделе Как избежать переполнения буфера.При использовании безопасных версий этих функций (либо суффикс _s, либо _p ) предоставленная пользователем строка форматирования может активировать исключение, связанное с недопустимым параметром, если эта строка содержит недопустимые символы форматирования.

См. также

Ссылки

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

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_copy, va_end, va_start