1dbh_create(3)          DBHashTables Programmers' Manual          dbh_create(3)
2
3
4
5‐
6

NAME

8       dbh_open, dbh_openR, dbh_create - open or create a new DBHashTable
9

SYNOPSIS

11       #include <dbh.h>
12
13       DBHashTable *dbh_open(constchar*path);
14       DBHashTable *dbh_openR(constchar*path);
15       DBHashTable *dbh_create (const char *path, unsigned char key_length);
16

DESCRIPTION

18       dbh_open  ()  opens  an existing DBHashTable at path in read/write mode
19       while dbh_openR () will open in read-only mode. To  create,  initialize
20       and  open  a new DBHashTable in read/write mode, dbh_create () is used.
21       key_length is the fixed length of the record access  key  and  must  be
22       less than 256. This only need be specified when the DBHashTable is cre‐
23       ated and initialized.
24
25

RETURN VALUE

27       On  success,  a pointer to a newly initialized and open DBHashTable  or
28       NULL if it fails (and errno is set appropriately).
29
30

NOTES

32        This  function will overwrite any file with the specified path includ‐
33       ing any previous DBH file.  Cuantified  keys assure that large DBHashes
34       are spread out optimally.
35
36

SEE ALSO

38       dbh  (0),  dbh_open (3), dbh_openR (3), dbh_close (3), dbh_destroy (3),
39       dbh_genkey (3)
40

Author

42       Edscott Wilson Garcia <edscott@xfce.org>
43
44
45
46DBHashTables                          DBH                        dbh_create(3)