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
       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_find-
       next 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+14.3.quarterly>

home | help