Функции библиотеки 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);
}

Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:

1 variable argument
2 variable arguments

Стандартная библиотека C - <stdio.h>

Другие расширения