Майкл Джонсон - Разработка приложений в среде 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] Вернее, они возвращаются в том порядке, в котором производятся ссылки на элементы из хеш-области. Хотя это и есть порядок, он является совершенно бесполезным. , а базу данных не нужно модифицировать во время итераций, производимых приложением.

int dpiterinit(DEPOT * depot);

char * dpiternext(DEPOT * depot, int * keySize);

В результате вызова функции dpiterinit() qdbmвернет первый ключ в базе данных во время следующего вызова функции dpiternext().

Функция dpiternext()возвращает указатель либо на первый ключ в базе данных (если только что была вызвана функция dpiterinit()), либо ключ в базе данных, который следует за ключом, возвращенным в последний раз. Если же в базе данных больше не окажется ключей, будет возвращено NULL. Если keySizeне равен NULL, то целочисленное значение, на которое указывает этот параметр, будет задано в качестве размера возвращаемого ключа.

Функция dpiternext()буфера возвращает указатель на размещение, выполненное функцией malloc(); после того как приложение завершит работу с ключом, указатель необходимо освободить функцией free(). Буфер также завершается NULL, поэтому при необходимости его можно трактовать как строку.

Предусмотрены две операции, которые модифицируют базу данных qdbm: добавление записей и удаление записей. Обновление записей производится с помощью той же функции, что и добавления записей.

Новые и обновленные записи заносятся в базу данных с использованием функции dpput().

int dpput(DEPOT * dfepot, const char * key, int keySize, const char * data,

int dataSize, int dmode);

keyпредставляет собой значение индекса, который впоследствии может использоваться для получения информации, на которую указывает data. Параметры keySizeи dataSizeмогут иметь значение -1, при котором функция dpput()будет использовать функцию strlen()для получения размера данного поля. Проверка параметра dmodeпроизводится только в том случае, если параметр keyв базе данных уже связан с элементом данных. Параметр dmodeможет иметь одно из перечисленных ниже значений.

Функция dpput()возвращает нулевое значение в случае возникновения ошибки (или если ключ уже существует, и было определено значение DP_DKEEP), и ненулевое значение, если данные для ключа были успешно обновлены.