DTMMDBSECTIONGETTOCLOC(3)

💅 DtMmdbSectionGetTocLoc — like, the TOC locator getter, bestie

okay so this is a page from the DtMmdbSectionGetTocLoc(library call) manual — yes that's the whole manual name, we're folding it in right here at the top so it doesn't feel left out 🫶 — and it's all about grabbing the locator for a book's TOC section. short page, elite function, let's go ✨

---

✨ NAME ✨

DtMmdbSectionGetTocLoc — obtains the locator for a book's TOC section

like, it gets you the locator. for the TOC section. of a book. that's the whole vibe 🎀

---

🌸 SYNOPSIS 🌸

#include &<DtMmdb.h>
const char* DtMmdbSectionGetTocLoc(
DtMmdbInfoRequest* request);

yes bestie, that's an & before <DtMmdb.h> and yes we're keeping it exactly as written, no cap, don't @ me 💀

---

🦋 DESCRIPTION 🦋

so the DtMmdbSectionGetTocLoc function returns the locator of the TOC section of the book that contains the specified section. that's it, that's the job, and it ate 👑

one little detail tho — table lookup is involved if the section identifier is specified by the locator_ptr field. so like, if you're coming in through the locator_ptr door, there's a table lookup happening behind the scenes. iykyk 🔥

---

💖 ARGUMENTS 💖

• request — specifies the bookcase in the bookcase descriptor field, plus either the section's Database Engine identifier (in the primary_oid field) or the section's logical identifier (in the locator_ptr field). and here's the tea: if both of these fields have a value, DtMmdbSectionGetTocLoc uses the locator_ptr value. so locator_ptr wins the main character competition, periodt 💅

---

⭐ RETURN VALUE ⭐

if DtMmdbSectionGetTocLoc completes successfully, it returns a pointer to the book's TOC section. slay ✨

if it fails, it returns a NULL pointer. sad girl hours 😭 — so like, always check for NULL, bestie, fr fr.

---

🌈 EXAMPLE 🌈

here's how a DtMmdbSectionGetTocLoc call might be coded, straight from the page:

DtMmdbInfoRequest request;
/* fill the request here */
locator = DtMmdbSectionGetTocLoc(&&request);

(and yes, that's &&request with two ampersands — copying it exactly because i am nothing if not faithful to the source 💜)

---

🧚 SEE ALSO 🧚

TO BE SUPPLIED

like 😭 they really left us on read with this one. no cross-references yet, we're in our waiting era 🍓

---

warning-ish heads up from your girl: keep the &<DtMmdb.h> include and the &&request exactly as they appear here. i'm not "fixing" them, i'm just reporting them. 🙈

---

and that's the page!! 💖 cute little sign-off: this footer is just the same DtMmdbSectionGetTocLoc(library call) label all over again, with no date or version in sight — so like, no extra info to spill, we're done here. bye bestie, go get those TOC locators 🎀🦋✨