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

NAME

8       dbh_load,  dbh_load_address,  dbh_load_parent,  dbh_load_child - load a
9       DBHashTable record to memory
10

SYNOPSIS

12       #include <dbh.h>
13
14       FILE_POINTER dbh_load (DBHashTable *dbh);
15       unsigned  char  dbh_load_address  (DBHashTable  *dbh,  FILE_POINTERcur‐
16       rentseek);
17       FILE_POINTER dbh_load_parent (DBHashTable *dbh);
18       FILE_POINTER    dbh_load_child   (DBHashTable   *dbh,   unsigned   char
19       key_index);
20

DESCRIPTION

22       dbh_load will load a record using the currently set key.  This function
23       will also load erased values, except that it will return 0.
24       dbh_load_address  will load a record from hash table directly from byte
25       offset currentseek.
26       dbh_load_parent will load the parent of the currently loaded record.
27       dbh_load_child will load  the  first  child  of  the  currently  loaded
28       record,  on branch identified by key_index.  Since the number of childs
29       (or branches) of each record is variable, this may be tricky. Top level
30       records  have  DBH_KEYLENGTH  branches.  Lower level records have less.
31       Each byte of a key represents a branch on top level records.
32

RETURN VALUE

34       dbh_load_address will return 0 on error, number of branches otherwise.
35       dbh_load, dbh_load_parent, dbh_load_child will return 0 on error,  byte
36       offset of loaded record otherwise.
37

SEE ALSO

39       dbh (0), dbh_update (3), dbh_macros (3),
40
41

Author

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