Функция snprintf () в C ++ используется для записи форматированной строки в буфер символьной строки.
В отличие от sprintf (), максимальное количество символов, которое может быть записано в буфер, указано в snprintf()
.
snprintf () прототип
int snprintf (char * buffer, size_t buf_size, const char * format,…);
snprintf()
Функция записывает строку , на которую указывает формат буфера. Максимальное количество символов, которые можно написать, составляет (buf_size-1)
.
После того, как символы записаны, добавляется завершающий нулевой символ. Если buf_size равен нулю, ничего не записывается и буфер может быть нулевым указателем.
Это определено в заголовочном файле.
snprintf () Параметры
- buffer: указатель на строковый буфер для записи результата.
- buf_size: укажите максимальное количество символов для записи в буфер, равное buf_size-1.
- формат: указатель на строку с завершающим нулем, которая записывается в файловый поток. Он состоит из символов и необязательных спецификаторов формата, начинающихся с%.
Спецификаторы формата заменяются значениями соответствующих переменных, следующих за строкой формата.
Спецификатор формата состоит из следующих частей:
- Ведущий знак%
- Флаги: необязательный один или несколько флагов, которые изменяют поведение преобразования.
- -: Выровнять результат по левому краю внутри поля. По умолчанию выравнивается по правому краю.
- +: Знак результата прикрепляется к началу значения даже для положительных результатов.
- Пробел: при отсутствии знака ставится пробел в начале результата.
- #: Выполняется альтернативная форма преобразования.
- 0: используется для целых чисел и чисел с плавающей запятой. Для дополнения чисел вместо пробела используются ведущие нули.
- Ширина: необязательное * или целочисленное значение, используемое для указания поля минимальной ширины.
- Точность: необязательное поле, состоящее из. за которым следует *, целое число или ничего, чтобы указать точность.
- Длина: необязательный модификатор длины, указывающий размер аргумента.
- Спецификатор: спецификатор формата преобразования. Доступные спецификаторы формата следующие:
Описатель формата Описание % Печать% c Записывает одиночный символ s Записывает символьную строку д или я Преобразует целое число со знаком в десятичное представление о Преобразует целое число без знака в восьмеричное представление X или x Преобразует целое число без знака в шестнадцатеричное представление. ты Преобразует целое число без знака в десятичное представление F или F Преобразует число с плавающей запятой в десятичное представление E или e Преобразует число с плавающей запятой в представление десятичной степени А или а Преобразует число с плавающей запятой в шестнадцатеричную экспоненту G или g Преобразует число с плавающей запятой в десятичное или десятичное представление экспоненты п Возвращает количество символов, записанных на данный момент этим вызовом функции. Результат записывается в значение, на которое указывает аргумент п Записывает последовательность символов, определяемую реализацией, определяющую указатель. Итак, общий формат спецификатора формата:
%(flags)(width)(.precision)(length)specifier
- …: Другие дополнительные аргументы, определяющие данные для печати. Они появляются в последовательности согласно спецификатору формата.
snprintf () Возвращаемое значение
В случае успеха snprintf()
функция возвращает количество символов, которые были бы записаны для достаточно большого буфера, за исключением завершающего нулевого символа. В случае неудачи возвращает отрицательное значение.
Вывод считается полностью записанным, если и только если возвращаемое значение неотрицательно и меньше buf_size.
Пример: как работает функция snprintf ()
#include #include using namespace std; int main() ( char buffer(100); int retVal, buf_size = 100; char name() = "Max"; int age = 23; retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age); if (retVal> 0 && retVal < buf_size) ( cout << buffer << endl; cout << "Number of characters written = " << retVal << endl; ) else cout << "Error writing to buffer" << endl; return 0; )
Когда вы запустите программу, вывод будет:
Привет, я Макс, мне 23 года Количество написанных символов = 34