cdb_firstkey(3)

💖 cdb_firstkey — find first physical record in constant database 💖

okay bestie, welcome to the Library Functions Manual ✨ this one's a lil function called cdb_firstkey(3) and she's here to help you find the very first record in your constant database. yes, the first one. the physical one. the main character of the record list. 👑

---

✨ SYNTAX ✨

like, here's how you summon her:

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

int cdb_firstkey(struct cdb *c, uint32 *kpos);

no cap, that's the whole thing. two includes, one function. clean. 💅

---

🌸 DESCRIPTION 🌸

so cdb_firstkey finds the physically first record in the constant database. that's it, that's the job. she shows up, she locates the first record, she hands it to you. iconic behaviour, honestly. 🦋

and once you've got it? you're not done yet, bestie — you still gotta get the details out of it. that's where her friends come in:

• use cdb_datapos or cdb_keypos to get the position 🔍
• use cdb_datalen and cdb_keylen to get the len 📏

like, cdb_firstkey gets you to the record, and those four are how you actually read what's in it. team effort fr fr 🫶

heads up: it's the physically first record, not like... a sorted or alphabetical first one. just so we're clear. no assumptions, okay? 😌

---

👀 SEE ALSO 👀

go read these next, they're the rest of the saga:

• cdb_nextkey(3) — the next episode 📖
• cdb_successor(3) — also part of the lore ✨

---

and that's the whole page, babe 💜 written up as cdb_firstkey(3), straight out of the Library Functions Manual — mwah, slay, go forth and find your first record 🌈⭐💖