Функция библиотеки Csprintf()
Стандартная библиотека C - <stdio.h>
Описание
Функции библиотеки Cint sprintf(char *str, const char *format, ...)Отправляет форматированный вывод вstrстроку, на которую указывает.
Объявление
Ниже приведено объявление функции sprintf().
int sprintf(char *str, const char *format, ...)
Параметр
- str-- Это указатель на массив символов, в котором хранится строка C.
- format-- Это строка, содержащая текст для записи в строку str. Она может содержать встроенные спецификаторы формата, которые могут быть заменены значениями, указанными в последующих дополнительных аргументах, и отформатированы по мере необходимости. Атрибуты спецификатора формата: %[flags][width][.precision][length]specifier, подробности объяснены ниже:
| спецификатор (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 | Аргумент интерпретируется как 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). |
- Дополнительные аргументы-- В зависимости от строки формата функция может требовать ряд дополнительных аргументов, каждый из которых содержит значение для вставки, заменяющее каждый тег %, указанный в параметре формата. Количество аргументов должно совпадать с количеством тегов %.
Возвращаемое значение
В случае успеха возвращается общее количество записанных символов, исключая нулевой символ, добавленный в конец строки. В случае неудачи возвращается отрицательное число.
Пример
Следующий пример демонстрирует использование функции sprintf().
Пример
#include <stdio.h>
#include <math.h>
int main()
{
char str[80];
sprintf(str, "The value of Pi = %f", M_PI);
puts(str);
return(0);
}
#include <math.h>
int main()
{
char str[80];
sprintf(str, "The value of Pi = %f", M_PI);
puts(str);
return(0);
}
Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:
Pi 的值 = 3.141593Другие расширения