dbm_store
Эту функцию применяют для ввода данных в базу данных. Как упоминалось ранее, все данные должны сохраняться с уникальным индексом. Для определения данных, которые вы хотите сохранить, и индекса, используемого для ссылки на них, следует задать два типа datum: один для ссылки на индекс, а другой — на реальные данные. Последний параметр
store_mode
управляет действиями, совершаемыми при попытке сохранить какие-либо данные с применением ключа, который уже существует. Если установлено значение параметра
dbm_insert
, сохранение завершается аварийно и функция
dbm_store
возвращает 1. Если установлено значение параметра
dbm_replace
, новые данные заменяют существующие и
dbm_store
возвращает 0. При возникновении других ошибок функция
dbm_store
возвращает отрицательные числа.
dbm_fetch
Подпрограмма
dbm_fetch
применяется для извлечения данных из базы данных. Она принимает в качестве параметра указатель dbm, возвращенный предшествующим вызовом функции
dbm_open
и тип
datum
, который должен быть задан как указатель на ключ. Тип
datum
возвращается, если данные, относящиеся к используемому ключу, найдены в базе данных, возвращаемая структура
datum
будет иметь значения
dptr
и
dsize
, ссылающиеся на возвращенные данные. Если ключ не найден,
dptr
будет равен
null
.
Примечание
Важно помнить, что функция
dbm_fetch
возвращает только параметр типа
datum
, содержащий указатель на данные. Реальные данные могут находиться в локальной области памяти внутри библиотеки dbm и должны быть скопированы в переменные программы перед дальнейшими вызовами функций dbm.
dbm_close
Эта подпрограмма закрывает базу данных, открытую функцией
dbm_open
, и должна получить указатель
DBM
, возвращенный предшествующим вызовом
dbm_open
.
А теперь выполните упражнение 7.12.
Упражнение 7.12. Простая база данных dbm
Познакомившись с основными функциями базы данных dbm, теперь вы знаете, как написать вашу первую программу для работы с dbm (dbm1.c). В этой программе применяется структура, названная
test_data
.
1. Первыми представлены файлы
#include
, директивы
#define
, функция
main
и объявление структуры
test_data
:
#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
#include <fcntl.h>
#include <ndbm.h>
/* В некоторых системах вам нужно заменить вышестоящую строку строкой #include <gdbm-ndbm.h>*/
#include <string.h>
#define TEST_DB_FILE "/tmp/dbm1_test"
#define ITEMS_USED 3
struct test_data {
char misc_chars[15];
int any_integer;
char more_chars[21];
};
int main() {
2. В функции
main
задайте элементы структур
items_to_store
и
items_received
, строку
key
и типы
datum
:
struct test_data items_to_store[ITEMS_USED];
struct test_data item_retrieved;
char key_to_use[20];
int i, result;
datum key_datum;
datum data_datum;
DBM *dbm_ptr;
3. Объявив указатель на структуру типа
DBM
, откройте вашу тестовую базу данных для чтения и записи, создав ее при необходимости:
dbm_ptr = dbm_open(TEST_DB_FILE, O_RDWR | O_CREAT, 0666);
if (!dbm_ptr) {
fprintf (stderr, "Failed to open database\n");
exit(EXIT_FAILURE);
}
4. Теперь добавьте данные в структуру
items_to_store
:
memset(items_to_store, '\0', sizeof(items_to_store));
strcpy(items_to_store[0].misc_chars, "First! ");
items_to_store[0].any_integer = 47;
strcpy(items_to_store[0].more_chars, "foo");
strcpy(items_to_store[1].misc_chars, "bar");
items_to_store[1].any_integer = 13;
strcpy(items_to_store[1].more_chars, "unlucky? ");
strcpy(items_to_store[2].misc_chars, "Third");
items_to_store[2].any_integer = 3;
strcpy(items_to_store[2].more_chars, "baz");
5. Для каждого элемента необходимо сформировать ключ для будущих ссылок в виде первой буквы каждой строки и целого числа. Этот ключ затем будет обозначен
key_datum
, когда
data_datum
сошлется на элемент
items_to_store
. Далее вы сохраняете данные в базе данных:
for (i = 0; i < ITEMS_USED; i++) {
sprintf(key_to_use, "%c%c%d",
items_to_store[i].misc_chars[0], items_to_store[i].more_chars[0], items_to_store[i].any_integer);
key_datum.dptr = (void*)key_to_use;
key_datum.dsize = strlen(key to_use);
