linux dbm数据库
大多数主流的Linux发行版都会默认安装gdbm,但在一些发行版中，你可能需要使用软件包管理器来安装相应的开发库。例如，在
ubuntu中，你可能需要使用Synaptic软件包管理器来安装libgdbm-dev软件包，因为它一般不会被默认安装。
dbm的数据块datum是一个用typedef语句定义的类型。它至少包含下面两个成员：
void *dptr;
size_t dsize;
dbm访问函数包括下面四个：
#include
DBM *dbm_open(const char *filename, int file_open_flags , mode_t mode);
int dbm_store(DBM *database_descriptor , datum key, datum content, int store_mode);
datum datum_fetch(DBM *database_descriptor , datum key);
void dbm_close(DBM *database_descriptor); 1.dbm_open函数
这个函数用来打开已有的数据库，也可以用来创建新数据库。filename参数是一个基本文件名，它不包含.dir或.pag后缀。
其余的参数与open函数的第二个和第三个参数一样。
dbm_open返回一个指向DBM类型的指针。它被用于所有后续对数据库的访问，如果失败，它将返回(DBM *)0。
2.dbm_store函数
你用这个函数把数据存储到数据库中，如前所述，所有数据在存储时都必须有一个唯一的索引。
为了定义你想要存储的数据和用来应用他的索引，你必须设置两个datum类型的参数：一个用于引用索引，一个用于实际
数据。最后一个参数store_mode用于控制当试图以一个已有的关键字来存储数据时发生的情况。如果它被设置为dbm_insert
，存储操作将失败并且dbm_store返回1.如果它被设置为dbm_replace,则新数据将覆盖已有数据并且dbm_store返回0.当发生
其他错误时，dbm_store将返回一个负值。
3.dbm_fetch函数
dbm_fetch函数用于从数据库中检索数据，它使用一个先前dbm_open调用返回的指针和一个指向关键字datum类型结构作为参数。
它返回一个datum类型的结构。如果在数据库中找到与这个与这个关键字关联的数据，但会的datum结构的dptr和dsize成员的
值将被设为相应数据的值。如果没有找到关键字，dptr将被设置为NULL；
4.dbm_close函数
这个函数用于关闭dbm_open函数打开的数据库。它的参数是先前dbm_open调用返回的dbm指针。
#include
#include
#include
#include
#include
/* On some systems you need to replace the above with
#include
*/
#include
#define TEST_DB_FILE "/tmp/dbm1_test"
#define ITEMS_USED 3
/* A struct to use to test dbm */
struct test_data {
char misc_chars[15];
int any_integer;
char more_chars[21];
};
int main() {
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;
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);
}
/* put some data in the structures */
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");
for (i = 0; i < ITEMS_USED; i++) {
/* build a key to use */
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);
/* build the key datum strcture */
key_datum.dptr = (void *)key_to_use;
key_datum.dsize = strlen(key_to_use);
data_datum.dptr = (void *)&items_to_store[i];
data_datum.dsize = sizeof(struct test_data);
result = dbm_store(dbm_ptr, key_datum, data_datum, DBM_REPLACE);
if (result != 0) {
fprintf(stderr, "dbm_store failed on key %s\n", key_to_use);
exit(2);
}
} /* for */
/* now try and retrieve some data */
sprintf(key_to_use, "bu%d", 13); /* this is the key for the second item */
key_datum.dptr = key_to_use; /*提供测试*/
key_datum.dsize = strlen(key_to_use);
data_datum = dbm_fetch(dbm_ptr, key_datum);
if (data_datum.dptr) {
printf("Data retrieved\n");
memcpy(&item_retrieved, data_datum.dptr, data_datum.dsize);
printf("Retrieved item - %s %d %s\n",
item_retrieved.misc_chars,
item_retrieved.any_integer,
item_retrieved.more_chars);
}
else {
printf("No data found for key %s\n", key_to_use);
}
dbm_close(dbm_ptr);
exit(EXIT_SUCCESS);
}
int dbm_delete(DBM *database_descriptor , datum key);
这个函数用于从数据库中删除数据项，与dbm_fetch一样，它也使用一个指向关键字的datum类型结构作为其参数，但不同的是，它是用于
删除数据而不是用于检索数据。它在成功时返回0.
int dbm_error(DBM *database_descriptor );
函数用于测试数据库中是否有错误发生，如果没有就返回0.
int dbm_clearerr(DBM *database_descriptor);
函数用于清除数据库中所有已被置位的错误条件标志。
datum dbm_firstkey(DBM *database_descriptor);
datum dbm_nextkey(DBM *database_descriptor);
这个两个函数一般成对来对数据库中的所有关键字进行扫描。他们需要的循环结构如下所示：
DBM *db_ptr;
datum key;
for(key=dbm_firstkey(db_ptr); key.dptr ; key = dbm_nextkey(db_ptr));
#include
#include
#include
#include
#include
/* On some systems you need to replace the above with
#include
*/
#include
#define TEST_DB_FILE "/tmp/dbm2_test"
#define ITEMS_USED 3
/* A struct to use to test dbm */
struct test_data {
char misc_chars[15];
int any_integer;
char more_chars[21];
};
int main() {
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;
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);
}
/* put some data in the structures */
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");
for (i = 0; i < ITEMS_USED; i++) {
/* build a key to use */
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);
/* build the key datum strcture */
key_datum.dptr = key_to_use;
key_datum.dsize = strlen(key_to_use);
data_datum.dptr = (void *)&items_to_store[i];
data_datum.dsize = sizeof(struct test_data);
result = dbm_store(dbm_ptr, key_datum, data_datum, DBM_REPLACE);
if (result != 0) {
fprintf(stderr, "dbm_store failed on key %s\n", key_to_use);
exit(2);
}
} /* for */
/* now try and delete some data */
sprintf(key_to_use, "bu%d", 13); /* this is the key for the second item */
key_datum.dptr = key_to_use;
key_datum.dsize = strlen(key_to_use);
if (dbm_delete(dbm_ptr, key_datum) == 0) {
printf("Data with key %s deleted\n", key_to_use);
}
else {
printf("Nothing deleted for key %s\n", key_to_use);
}
for (key_datum = dbm_firstkey(dbm_ptr);
key_datum.dptr;
key_datum = dbm_nextkey(dbm_ptr)) {
data_datum = dbm_fetch(dbm_ptr, key_datum);
if (data_datum.dptr) {
printf("Data retrieved\n");
memcpy(&item_retrieved, data_datum.dptr, data_datum.dsize);
printf("Retrieved item - %s %d %s\n",
item_retrieved.misc_chars,
item_retrieved.any_integer,
item_retrieved.more_chars);
}
else {
printf("Woops - no data found for key %s\n", key_to_use);
}
} /* for each key */
dbm_close(dbm_ptr);
exit(EXIT_SUCCESS);
}