Операционная система ЗОСРВ «Нейтрино» > Руководство разработчика > Программные интерфейсы общего назначения > Прикладные библиотеки и технологии > Библиотека менеджера QDB > Справочник по клиентскому API менеджера QDB > qdb_snprintf()

qdb_snprintf()

Печать форматированной информации в строковую переменную, но не более заданного максимального количества символов

Прототип:

#include <qdb/qdb.h>
                                       
char * qdb_snprintf( int n,
                     char *buf,
                     const char *format,
                     ... );

Аргументы:

n

Максимальное число символов, записываемых в буфер, включая терминальный "\0". Функция всегда записывает "\0", если n положительный.

buf

Указатель на буфер для записи форматированной строки.

format

Формат обрабатываемой информации, во многом аналогичный printf().

...

Дополнительные параметры для печати.

Библиотека:

qdb

Описание:

Данная функция является вариацией вызова snprintf(), за исключением:

• qdb_snprintf() возвращает указатель на буфер, а не число записанных символов
• порядок параметров n и buf в прототипе функции обратный
• qdb_snprintf() всегда записывает "\0", если n положительный

Аргумент format поддерживает дополнительные спецификаторы "%q" и "%Q", которые описаны на странице qdb_mprintf().

---

Функция является псевдонимом для sqlite3_snprintf().

---

Возвращаемое значение:

Указатель на буфер

Успешное завершение.

NULL

Возникла ошибка. Код ошибки записан в errno.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Тематические ссылки:

qdb_mprintf(), printf()

Предыдущий раздел: перейти