dbh_create(3)

💖 NAME 💖

ok so bestie, meet the girlies: dbh_open, dbh_openR, and dbh_create — they open a DBHashTable or make a brand new one, no cap 💅

---

✨ SYNOPSIS ✨

#include <dbh.h>

DBHashTable *dbh_open(constchar*path);
DBHashTable *dbh_openR(constchar*path);
DBHashTable *dbh_create (const char *path, unsigned char key_length);

---

🌸 DESCRIPTION 🌸

okay so here's the tea 🫖 — you've got three functions and they each have main character energy in their own way:

• dbh_open() — opens an existing DBHashTable at path in read/write mode. She's got range, she can do both.
• dbh_openR() — same path, but opens in read-only mode. Look but don't touch, periodt. 👀
• dbh_create() — the icon herself ✨ she creates, initializes and opens a new DBHashTable in read/write mode.

and about key_length: it's the fixed length of the record access key, and it must be less than 256. it's giving very specific, very demure. 🙈

ngl the important bit: you only gotta specify key_length when the DBHashTable is being created and initialized. after that, she already knows who she is. 🎀

---

🦋 RETURN VALUE 🦋

when it slays (success 💖): you get back a pointer to a newly initialized and open DBHashTable. iconic.

when it doesn't: you get NULL 😭 and errno gets set appropriately, so go check on her.

---

💀 NOTES 💀

⚠️ WARNING bestie, this is the serious one ⚠️ dbh_create() will overwrite any file with the specified path — and that includes any previous DBH file. like, gone gone. no undo. 🙈 so pls be sure before you commit.

also, lowkey a flex: Cuantified keys assure that large DBHashes are spread out optimally. she's optimized, she's balanced, she's thriving 🌈⭐

---

👑 SEE ALSO 👑

• dbh (0)
• dbh_open (3)
• dbh_openR (3)
• dbh_close (3)
• dbh_destroy (3)
• dbh_genkey (3)

---

🌷 Author 🌷

Edscott Wilson Garcia <edscott@xfce.org> — the original main character, we stan 🫶

---

k bye bestie, that's the whole DBHashTables Programmers' Manual page for dbh_create(3), version DBH 🎀 go forth and hash responsibly, mwah 💅✨