Майкл Джонсон - Разработка приложений в среде Linux. Второе издание

int dpfdesc(DEPOT * depot);

Эта функция возвращает файловый дескриптор базы данных depqt [179] Несмотря на то что qdbm обеспечивает доступ к файловому дескриптору, использовать его следует осторожно. Дело в том, что все операции по чтению и записи в файл должны производиться через библиотеку qdbm ; операции, не связанные с изменением данных в файле, например, блокировка или установка флага для закрытия после выполнения, допускаются. .

qdbmкэширует данные в оперативной памяти для ускорения доступа к базе данных, а ядро Linux кэширует записи на диске, чтобы свести к минимуму задержку между вызовами функции write(). Чтобы база данных, хранящаяся на диске, оставалась согласованной с буферизированными структурами, приложение может осуществлять ее синхронизацию. В процессе синхронизации базы данных qdbm очищает все ее внутренние буферы и вызывает функцию fsync()для файлового дескриптора.

int dpsync(DEPOT * depot);

Прочитать записи в базе данных можно двумя способами: посредством поиска записи по ее ключу и путем чтения последовательных пар "ключ-значение".

Функции dpget()и dpgetwb()производят поиск записей в базе данных по ключу.

int dpget(DEPOT * depot, const char * key, int keySize, int start,

int max, int * dataSize);

keyявляется элементом (ключом), с помощью которого производится поиск по базе данных, a keySizeопределяет длину ключа (или значение -1, при котором Depotиспользует функцию strlen(key)для определения длины ключа). С помощью следующих двух параметров, startи max, можно производить частичное чтение записей; параметр startзадает смещение в данных, с которого начнется операция чтения, а max— максимальное количество байтов для чтения. Например, если область данных представляла бы собой массив из четырехбайтовых целочисленных значений int, то в результате присвоения параметру startзначения 12и параметру maxзначения 8производилось бы чтение четвертого и пятого элементов массива. Если для чтения доступно менее startбайтов, функция dpget()вернет NULL. Чтобы прочитать все байты из данных, параметру maxследует присвоить значение -1.

Если последний параметр, dataSize, не будет равен NULL, то целое число, на которое он указывает, будет соответствовать количеству прочитанных байтов.

В случае сбоя эта функция возвращает NULL, а в случае успешного завершения она возвращает указатель на прочитанные данные. В случае сбоя dpcodeсообщает о том, что стало причиной сбоя. В частности, если элемент не существует или имеет менее startбайтов данных, dpcodeбудет присвоено DP_ENOITEM.

Когда функция dpget()возвращает данные, к ним добавляется байт 0, позволяя работать с ними как со строкой. Размещение указателя производится с помощью функции malloc(), и приложение отвечает за освобождение памяти после завершения своей работы. Если приложениям необходимо поместить данные в буфер, вместо того чтобы Depotразмещала его с помощью функции malloc(), то они должны использовать функцию dpgetwb().

int dpgetwb(DEPOT * depot, const char * key, int keySize, int start,

int max, const char * data);

Функции dpgetwb()и dpget()отличаются друг от друга только двумя параметрами: max(который интерпретируется по-разному) и data(который заменяет параметр dataSizeиз функции dpgetwb()). Параметр dataдолжен указывать на буфер из maxбайтов, в который функция dpgetwb()будет помещать данные, прочитанные из базы данных. В функции dpgetwb()параметр maxне должен иметь значение -1, и буфер не будет иметь байт 0, автоматически добавляемый в него этой функцией. Функция dpgetwb()возвращает количество байтов, хранящихся в data, и -1, если запись не была найдена, если данных оказалось меньше startбайтов или если возникла ошибка.

С помощью функций dpiterinit()и dpiternext()приложения могут производить итерации по всем ключам в базе данных. Ключи не возвращаются в каком-то определенном порядке [180] Вернее, они возвращаются в том порядке, в котором производятся ссылки на элементы из хеш-области. Хотя это и есть порядок, он является совершенно бесполезным. , а базу данных не нужно модифицировать во время итераций, производимых приложением.