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