Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
cdb_find(3)		    Library Functions Manual		     cdb_find(3)

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, size_t keylen);
     int cdb_datalen(struct cdb *c);
     int cdb_datapos(struct cdb *c);
     int cdb_findnext(struct cdb *c, char *key, size_t keylen);

DESCRIPTION
     cdb_find  looks  for key. If cdb_find returns 0, the database does not con-
     tain 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_cdb_find&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help