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

qdb_rowchanges()

Определение числа строк, затронутых запросом

Прототип:

#include <qdb/qdb.h>
                                       
uint64_t qdb_rowchanges( qdb_hdl_t *hdl
                         qdb_result_t *result );

Аргументы:

hdl: Указатель на дескриптор базы данных. Значение NULL можно передать, если опция QDB_OPTION_ROW_CHANGES была установлена с помощью qdb_setoption() (установлена по умолчанию).
result: Указатель на результат операции. Передача NULL позволяет функции запросить у сервиса результаты последнего запроса, выполненного через qdb_statement() на соединении hdl.

Функция позволяет определить число строк, затронутых запросом к базе данных. В первую очередь просматривается содержимое result (если установлена опция QDB_OPTION_ROW_CHANGES), возвращая число строк из запроса. Если result равен NULL или отключена опция QDB_OPTION_ROW_CHANGES, функция запрашивает у базы данных hdl сведения о последнем выполненном запросе.

Если функция возвращает 0, следует проверить errno на равенство EOK, что укажет на отсутствие затронутых запросом строк ( errno следует предварительно установить в 0, чтобы отличить ошибку и 0 строк в запросе). Если errno установлена, запрос был выполнен с ошибками.

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

>: 0 Число затронутых запросом строк.
0: Возникла ошибка или нет затронутых строк. Код ошибки записан в errno.

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

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

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

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

qdb_setoption(), qdb_statement()

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