Функции библиотеки C -fprintf()

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

Описание

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

Объявление

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

int fprintf(FILE *stream, const char *format, ...)

Параметр

  • 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Нет вывода
%Символ

флагиОписание
-Выравнивание по левому краю в пределах заданной ширины поля; по умолчанию — по правому краю (см. подспецификатор ширины).
+Принудительно отображает знак плюс или минус (+ или -) перед результатом, то есть перед положительными числами отображается знак +. По умолчанию знак - отображается только перед отрицательными числами.
(пробел)Если знак не указан, вставьте пробел перед значением.
#При использовании со спецификаторами o, x или X ненулевое значение предваряется соответственно 0, 0x или 0X.
При использовании с e, E и f он заставляет вывод содержать десятичную точку, даже если после неё нет цифр. По умолчанию, если после неё нет цифр, десятичная точка не отображается.
При использовании с g или G результат такой же, как при использовании e или E, но конечные нули не удаляются.
0Размещает нули (0) слева от числа, когда указано заполнение, вместо пробелов (см. подспецификатор ширины).

widthОписание
(число)Минимальное количество символов для вывода. Если выходное значение короче этого числа, результат дополняется пробелами. Если выходное значение длиннее этого числа, результат не усекается.
*Ширина не указана в строке формата, а задаётся дополнительным целочисленным аргументом, размещённым перед аргументом, который нужно отформатировать.

.точностьОписание
.числоДля целочисленных спецификаторов (d, i, o, u, x, X): точность задаёт минимальное количество выводимых цифр. Если выводимое значение короче этого числа, результат дополняется ведущими нулями. Если выводимое значение длиннее этого числа, результат не усекается. Точность, равная 0, означает, что символы не выводятся.
Для спецификаторов e, E и f: количество цифр, выводимых после десятичной точки.
Для спецификаторов g и G: максимальное количество значащих цифр для вывода.
Для s: максимальное количество выводимых символов. По умолчанию выводятся все символы до встречи с завершающим нулевым символом.
Для типа c: не оказывает эффекта.
Если точность не указана, по умолчанию используется 1. Если она указана без явного значения, предполагается 0.
.*Точность не указывается в строке формата, а задаётся дополнительным целочисленным аргументом, размещённым перед форматируемым аргументом.

lengthОписание
hАргумент интерпретируется как короткое целое или беззнаковое короткое целое (применимо только к целочисленным спецификаторам: i, d, o, u, x и X).
lАргумент интерпретируется как длинное целое или беззнаковое длинное целое; применимо к целочисленным спецификаторам (i, d, o, u, x и X), а также к спецификаторам c (обозначает широкий символ) и s (обозначает строку широких символов).
LАргумент интерпретируется как long double (применимо только к спецификаторам с плавающей точкой: e, E, f, g и G).
  • Дополнительные аргументы-- В зависимости от строки формата функция может требовать ряд дополнительных аргументов, каждый из которых содержит значение для вставки, заменяющее каждый тег %, указанный в параметре формата. Количество аргументов должно совпадать с количеством тегов %.

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

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

Пример

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

Пример

#include <stdio.h>
#include <stdlib.h>

int main()
{
   FILE * fp;

   fp = fopen ("file.txt", "w+");
   fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014);
   
   fclose(fp);
   
   return(0);
}

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

We are in 2014

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

Пример

#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>

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