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

qdb_collation()

Изменение последовательности сортировки в процессе исполнения

Прототип:

#include <qdb/qdb.h>
                                       
int qdb_collation( qdb_hdl_t *db,
                   void *data,
                   int nbytes,
                   int reindex );

Аргументы:

db: Указатель на дескриптор базы данных.
data: Указатель на произвольные данные, используемые пользовательской библиотекой сортировки.
nbytes: Длина данных в байтах.
reindex: Флаг, указывающий, следует ли QDB переиндексировать любые индексы в базе данных, на которые может повлиять изменение параметров сортировки. Если существуют индексы с COLLATE, их необходимо обработать повторно, чтобы отобразить верно новый параметр сортировки.

Функция используется для настройки специальных пользовательских сортировок, присоединённых к базе данных, заданной параметром __Collation=__ в конфигурационном файле. Функция setup() вызывается для каждой записи с передачей параметров data и nbytes, а любая возникшая ошибка возвращается клиенту. В противном случае функция сортировки должна использовать данные самостоятельно для настройки нового порядка сортировки. Функция сортировки и клиент должны синхронизировать формат данных. Для этих целей можно рассмотреть использование getsubopt().

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

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

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

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

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

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

qdb_query()

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