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



qdb_statement()

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

Прототип:

#include <qdb/qdb.h>
int qdb_statement( qdb_hdl_t *hdl,
const char *format,
... );

Аргументы:

hdl
Указатель на дескриптор базы данных.
format
Формат обрабатываемой информации, во многом аналогичный printf(). Форматированная строка исполняется как SQL запрос к базе данных, характеризуемой параметром hdl.
...
Дополнительные параметры для печати.

Библиотека:

qdb

Описание:

Данная функция исполняет SQL запрос, сформированный как форматированная строка из перечня аргументов. SQL-оператор должен быть завершён точкой с запятой. Таких операторов в строке может быть несколько.

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

Если исполняется несколько запросов (SQL-операторов), возвращается число затронутых послед оператором строк.


Note: Запросы могут исполняться как синхронно, так и асинхронно. Подробнее см. в разделе "Использование асинхронного режима" в описании qdb_connect().

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

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

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

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

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

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

qdb_mprintf(), qdb_vmprintf(), printf()




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