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

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

Описание

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

Объявление

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

int vsprintf(char *str, const char *format, va_list arg)

Параметр

  • str-- Это указатель на массив символов, в котором хранится C-строка.
  • format-- Это строка, содержащая текст, который будет записан в строку str. Она может содержать встроенные теги формата, которые могут быть заменены значениями, указанными в последующих дополнительных аргументах и отформатированными по мере необходимости. Свойства тега формата: %[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Описание
(число)Минимальное количество символов для вывода. Если выводимое значение короче этого числа, результат дополняется пробелами. Если выводимое значение длиннее этого числа, результат не усекается.
*Ширина не указана в строке формата, а задаётся дополнительным целочисленным аргументом, размещённым перед аргументом, который нужно отформатировать.

.точностьОписание
.числоДля целочисленных спецификаторов (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>.

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

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

Пример

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

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

char buffer[80];
int vspfunc(char *format, ...)
{
   va_list aptr;
   int ret;

   va_start(aptr, format);
   ret = vsprintf(buffer, format, aptr);
   va_end(aptr);

   return(ret);
}

int main()
{
   int i = 5;
   float f = 27.0;
   char str[50] = "example.com";

   vspfunc("%d %f %s", i, f, str);
   printf("%s\n", buffer);
   
   return(0);
}

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

5 27.000000 example.com

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

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