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

qdb_query()

Исполнение SQL запроса

Прототип:

#include <qdb/qdb.h>
                                       
qdb_result_t * qdb_query( qdb_hdl_t *db,
                          int size_hint,
                          const char *format,
                          ... );

Аргументы:

db: Указатель на дескриптор базы данных.
size_hint: Оценка (в байтах) того, сколько памяти необходимо первоначально выделить для получения результатов запроса к базе данных. При задании 0 используется значение по умолчанию. Указание конкретного значения несколько повышает производительность. В любом случае будет получен полный результат.
format: Формат обрабатываемой информации, во многом аналогичный printf(). Форматированная строка исполняется как SQL запрос к базе данных, характеризуемой параметром db. Подробнее см. qdb_statement().
...: Дополнительные параметры для печати.

Функция предоставляет альтернативу паре вызовов qdb_statement() и qdb_getresult() с потенциальным преимуществом в производительности, если передача запроса и приём результата могут осуществляться с единственным переключением контекста процесса.

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

≥0: Успешное завершение.
-1: Возникла ошибка. Код ошибки записан в errno.

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

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

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Да

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

qdb_statement(), qdb_getresult()

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