NAME

       cdb_find - look up a key in a constant database

SYNTAX

       #include <libowfat/cdb.h>
       #include <libowfat/uint32.h>

       int cdb_find(struct cdb *c,char *key,unsigned long int keylen);
       int cdb_datalen(struct cdb *c);
       int cdb_datapos(struct cdb *c);
       int cdb_findnext(struct cdb *c,char *key,unsigned long int keylen);

DESCRIPTION

       cdb_find  looks for key. If cdb_find returns 0, the database does not contain that key; stop. If cdb_find
       returns -1, there was a read error; abort.

       cdb_datalen returns the length of the data associated with the key.  Use it to allocate a pointer p  with
       enough space to hold the data.

       cdb_datapos returns the position of the data inside the file.  Use it as argument to cdb_read to retrieve
       the data.

       There  may  be several records under a single key. You can use cdb_findnext to find the next record under
       this key.

EXAMPLE

       static struct c;

       if (cdb_find(&c,key,strlen(key)>0) {
         char *buf=alloca(cdb_datalen(&c));
         cdb_read(&c,buf,cdb_datalen(&c),cdb_datapos(&c));
         write(1,buf,cdb_datalen(&c));
       }

SEE ALSO

       cdb_read(3), cdb_init(3), cdb_free(3), cdbmake(1)

                                                                                                     cdb_find(3)