Функция библиотеки 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);
}

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

Pi 的值 = 3.141593

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

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