Функция библиотеки 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);
}
Другие расширения