Функции библиотеки C -vprintf()
Стандартная библиотека C - <stdio.h>
Описание
Функции библиотеки Cint vprintf(const char *format, va_list arg)Отправляет форматированный вывод в стандартный поток вывода stdout, используя список параметров.
Объявление
Ниже приведено объявление функции vprintf().
int vprintf(const char *format, va_list arg)
Параметр
- format-- Это строка, содержащая текст, который должен быть записан в стандартный поток вывода stdout. Она может содержать встроенные теги формата, которые могут быть заменены значениями, указанными в последующих дополнительных аргументах, и отформатированы по мере необходимости. Свойства тега формата: %[flags][width][.precision][length]specifierПодробное объяснение приведено ниже:
| спецификатор | Вывод |
|---|---|
| c | Символ |
| d или i | Десятичное целое число со знаком |
| e | Экспоненциальная запись с использованием символа e (мантисса и экспонента) |
| E | Экспоненциальная запись с использованием символа E (мантисса и экспонента) |
| f | десятичное число с плавающей запятой |
| g | Автоматически выбирает подходящее представление между %e и %f |
| G | Автоматически выбирает подходящее представление между %E и %f |
| o | восьмеричное число со знаком |
| s | строка символов |
| u | Беззнаковое десятичное целое |
| x | Беззнаковое шестнадцатеричное целое |
| X | Беззнаковое шестнадцатеричное целое (заглавные буквы) |
| p | Адрес указателя |
| n | Нет вывода |
| % | Символ |
| флаги | Описание |
|---|---|
| - | Выравнивает вывод по левому краю в пределах заданной ширины поля; по умолчанию используется выравнивание по правому краю (см. подспецификатор width). |
| + | Принудительно добавляет знак плюс или минус (+ или -) перед результатом, т. е. положительные числа будут отображаться со знаком +. По умолчанию знак - ставится только перед отрицательными числами. |
| (пробел) | Если знак не указан, перед значением вставляется пробел. |
| # | При использовании со спецификаторами o, x или X ненулевое значение предваряется 0, 0x или 0X соответственно. При использовании с e, E и f принудительно включает десятичную точку в вывод, даже если после нее нет цифр. По умолчанию, если после десятичной точки нет цифр, десятичная точка не отображается. При использовании с g или G результат такой же, как с e или E, но конечные нули не удаляются. |
| 0 | Помещает нули (0) слева от цифр, заполняющих отступ, вместо пробелов (см. подспецификатор width). |
| width | Описание |
|---|---|
| (число) | Минимальное количество символов для вывода. Если выводимое значение короче этого числа, результат дополняется пробелами. Если выводимое значение длиннее этого числа, результат не усекается. |
| * | Ширина не указана в строке формата, а задаётся дополнительным целочисленным аргументом, размещённым перед аргументом, который нужно отформатировать. |
| .точность | Описание |
|---|---|
| .число | Для целочисленных спецификаторов (d, i, o, u, x, X): точность задаёт минимальное количество цифр для вывода. Если выводимое значение короче этого числа, результат дополняется ведущими нулями. Если выводимое значение длиннее этого числа, результат не усекается. Точность 0 означает, что не выводится ни одного символа. Для спецификаторов e, E и f: количество десятичных цифр, выводимых после десятичной точки. Для спецификаторов g и G: максимальное количество значащих цифр для вывода. Для s: максимальное количество выводимых символов. По умолчанию выводятся все символы до встречи с завершающим нулевым символом. Для типа c: не оказывает эффекта. Если точность не указана, по умолчанию используется 1. Если она указана без явного значения, подразумевается 0. |
| .* | Точность не указывается в строке формата, а задаётся дополнительным целочисленным аргументом, размещённым перед форматируемым аргументом. |
| length | Описание |
|---|---|
| h | Аргумент интерпретируется как short int или unsigned short int (применяется только к целочисленным спецификаторам: i, d, o, u, x и X). |
| l | Аргумент интерпретируется как long int или unsigned long int; применимо к целочисленным спецификаторам (i, d, o, u, x и X) и спецификаторам c (обозначает широкий символ) и s (обозначает строку широких символов). |
| L | Аргумент интерпретируется как long double (применяется только к спецификаторам с плавающей точкой: e, E, f, g и G). |
- arg-- Объект, представляющий список переменных аргументов. Он должен быть инициализирован с помощью макроса va_start, определённого в <stdarg>.
Возвращаемое значение
В случае успеха возвращает общее количество записанных символов; в противном случае возвращает отрицательное число.
Пример
Следующий пример демонстрирует использование функции vprintf().
Пример
#include <stdio.h>
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:
1 variable argument 2 variable argumentsДругие расширения