C ++ snprintf () - Стандартная библиотека C ++

Функция 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

Интересные статьи...