cdb_find(3)

💖 NAME 💖

okay so bestie, welcome to cdb_find — the function that goes and looks up a key in a constant database. that's the whole vibe. 🎀

this one lives in the Library Functions Manual, section 3, and honestly? it ate. ✨

---

🌸 SYNTAX 🌸

first, you gotta pull in the headers like the little icons they are:

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

and here are the four function besties you're working with:

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 👑

so cdb_find looks for key, periodt. here's the tea on what it hands back:

• if cdb_find returns 0, the database does not contain that key. so like… stop. that's it. 🙈
• if cdb_find returns -1, there was a read error — abort. no cap, something went wrong. 💀

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. like, you need a spot big enough to put the data in, and this tells you how big. 💅

cdb_datapos returns the position of the data inside the file. use it as the argument to cdb_read to retrieve the data. that's the where, and cdb_read is the how. 🦋

alsooo — heads up — there may be several records under a single key. not just one. so if you wanna keep going, use cdb_findnext to find the next record under this key. it's giving "there's more where that came from." 🔥

---

✨ EXAMPLE ✨

here's the little snippet, copied exactly because we do not touch the code, bestie:

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));
}

not me double-checking that strlen(key)>0 is literally in there. it is. leave it. 🫶

---

🎀 SEE ALSO 🎀

go give these icons a read too, iykyk:

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

---

and that's the whole page, bestie!! 💜 you just read cdb_find(3) in all its glory — same page name, top to bottom, no notes. slay, go look up some keys. 🌈⭐🍓 🧚