dbh_set_size(3)

💖 dbh_set_size(3) — DBHashTables Programmers' Manual 💖

okay bestie, we're in the DBHashTables programmer's manual, section 3, and today's main character is dbh_set_size 💅

---

✨ NAME ✨

dbh_set_size, dbh_set_recordsize — set maximum or current record size 🎀

---

🦋 SYNOPSIS 🦋

#include <dbh.h>

int dbh_set_size (DBHashTable *dbh, FILE_POINTERsize);
void dbh_set_recordsize (DBHashTable *dbh, int record_size );

---

🌸 DESCRIPTION 🌸

so there's two functions here and they're lowkey cousins, but they do different things, ok? let's go 💜

dbh_set_size defines the maximum amount of memory that's gonna be allocated to the DBHashTable records. and listen — this is nonvolatile information, meaning you literally only need to set it once and it sticks. the default is 1024 bytes. no cap. ⭐

dbh_set_recordsize sets the recordsize of the data in the current DBHashTable, and it gets called implicitly by calling dbh_set_data. so if you're using dbh_set_data you're already covered, bestie 🫶

but fr fr: it is very important to call this function if dbh_set_data is not used. Unpredictable results will follow if record_size is not set. like, chaos. we don't want chaos. 😭

DBHashTable records are variable in length, so use this function at least once if you're planning to use fixed length records. the parameter record_size is the amount of bytes to be reserved for the current DBHashTable record data. that's the whole vibe. ✨

---

👑 RETURN VALUE 👑

• dbh_set_size returns 0 on error, 1 otherwise. (yes, 0 means error here, it's giving chaotic but that's just how it is 🙈)
• dbh_set_recordsize returns the amount of bytes in the current DBHashTable record.

---

🌈 SEE ALSO 🌈

• dbh (0)
• dbh_update (3)
• dbh_writeheader (3)
• dbh_set_data (3)
• dbh_set_key (3)

---

🎀 Author 🎀

Edscott Wilson Garcia <edscott@xfce.org> — iconic, we stan 💖

---

and that's the tea, bestie 🍓 this page came to you from DBHashTables, version DBH, as dbh_set_size(3) — go forth and set your sizes correctly, mwah 💅✨🧚