Функция библиотеки Cvfprintf()

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

Описание

Функции библиотеки Cint vfprintf(FILE *stream, const char *format, va_list arg)Отправляет форматированный вывод в поток, используя список аргументов.

Объявление

Ниже приведено объявление функции vfprintf().

int vfprintf(FILE *stream, const char *format, va_list arg)

Параметр

  • stream-- Это указатель на объект FILE, который идентифицирует поток.
  • format-- Это строка C, содержащая текст, который должен быть записан в поток. Она может содержать встроенные теги формата, которые заменяются значениями, указанными в последующих дополнительных аргументах, и форматируются по мере необходимости. Атрибуты тега формата: %[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>.

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

В случае успеха возвращается общее количество записанных символов; в противном случае возвращается отрицательное число.

Пример

Следующий пример демонстрирует использование функции vfprintf().

#include <stdio.h>
#include <stdarg.h>

void WriteFrmtd(FILE *stream, char *format, ...)
{
   va_list args;

   va_start(args, format);
   vfprintf(stream, format, args);
   va_end(args);
}

int main ()
{
   FILE *fp;

   fp = fopen("file.txt","w");

   WriteFrmtd(fp, "This is just one argument %d \n", 10);

   fclose(fp);
   
   return(0);
}

Давайте скомпилируем и запустим вышеприведённую программу; она откроет файл в текущем каталогеfile.txtи запишет следующее содержимое:

This is just one argument 10

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

#include <stdio.h>

int main ()
{
   FILE *fp;
   int c;

   fp = fopen("file.txt","r");
   while(1)
   {
      c = fgetc(fp);
      if( feof(fp) )
      {
          break ;
      }
      printf("%c", c);
   }
   fclose(fp);
   return(0);
}

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

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