DTMMDBSECTIONGETLONGTITLE(3)

🎀 DtMmdbSectionGetLongTitle 🎀

okay bestie, this one lives in the library call manual, and she's here to pull the long title for a section. no cap, that's the whole main-character job. 💖

✨ NAME ✨

DtMmdbSectionGetLongTitle — obtains the long title for a section. it's giving long-title retrieval, honestly. 🫶

🌸 SYNOPSIS 🌸

#include &<DtMmdb.h>
const char* DtMmdbSectionGetLongTitle(
DtMmdbInfoRequest* request,
unsigned int* length);

🦋 DESCRIPTION 🦋

so DtMmdbSectionGetLongTitle returns the long title for the specified section. 💅

⚠️ do not use the free function on the returned pointer, bestie — I'm serious, that's a no-no. 😭

also lowkey important: table lookup is involved if the section identifier is specified by the locator_ptr field. iykyk. ✨

🔥 ARGUMENTS 🔥

• request — specifies the bookcase in the bookcase descriptor field and either the section's Database Engine identifier (in the primary_oid field) or the section's logical identifier (in the locator_ptr field). if both of these fields have a value, DtMmdbSectionGetLongTitle uses the locator_ptr value. slay, that's the rule. 💖
• length — specifies the variable to receive the length of the returned long title, if the returned pointer to the title is not NULL. got it? 🎀

💫 RETURN VALUE 💫

if DtMmdbSectionGetLongTitle completes successfully, it returns a pointer to a NULL-terminated long title character string. if it fails, it returns a NULL pointer. that's the vibe check: string pointer or nothing, periodt. 🌈

🧚 EXAMPLE 🧚

the following shows how a DtMmdbSectionGetLongTitle call might be coded. note: this is exactly the example from the page, double ampersand and all — I'm keeping it character-for-character. 💀

DtMmdbInfoRequest request;
/* fill the request field here */
DtMmdbSectionGetLongTitle(&&request);

👑 SEE ALSO 👑

• DtMmdbSectionGetShortTitle(3)

---

and that's the whole page, bestie 💜 source/version: library call; date: the original footer doesn't print one, so no invented date here. fr fr, mwah 🫶✨