DTMMDBBOOKGETTABLIST(3)

🌸 NAME 🌸

hey bestie 💖 this is the DtMmdbBookGetTabList library call page, and it obtains the list of tab sections in a book — very “i know my way around a DtInfo Database” energy, no cap ✨

---

✨ SYNOPSIS ✨

       #include &<DtMmdb.h>
       DtMmdbHandle** DtMmdbBookGetTabList(
       DtMmdbInfoRequest* request,
       unsigned int* length);

---

💅 DESCRIPTION 💅

okay so DtMmdbBookGetTabList returns the list of tab sections for the specified book object 🫶 it hands you that list in a NULL-terminated array, which is iconic of it.

when you’re done with the array, use DtMmdbFreeHandleList to release the memory — do not ghost that cleanup step, bestie 😭

table lookup is involved when the identifier is specified by either the primary_oid or sequence_num field. that’s the whole tea 🍓

---

🎀 ARGUMENTS 🎀

• request — specifies the bookcase in the bookcase descriptor field, plus a valid value in the primary_oid, the secondary_oid, or the sequence_num field. primary_oid represents the DtInfo Database object identifier of the TOC section; secondary_oid represents the object identifier of the book itself; and sequence_num represents the sequence number of the book within the bookcase (0 based). if more than one of these fields has a valid value, the order of precedence is: primary_oid, secondary_oid, and, last, sequence_num 👑
• length — specifies the variable to receive the length of the returned list of sections, if the returned pointer to the list is not NULL 🎯

---

🦋 RETURN VALUE 🦋

if DtMmdbBookGetTabList completes successfully, it returns a pointer to the list of sections for the book 💖 if it fails, it returns a NULL pointer 💀

---

🌈 EXAMPLE 🌈

None. literally none, bestie — the example section is serving emptiness 🙈

---

⭐ SEE ALSO ⭐

TO BE SUPPLIED. yep, that’s the whole see-also situation rn 🧚

---

catch u later, bestie 💅 — the footer on this one is just the DtMmdbBookGetTabList library-call label, with no extra source/version or date tucked in, so that’s the whole cute sign-off ✨🫶