DTMMDBBOOKGETLONGTITLE(3)

🎀 DtMmdbBookGetLongTitle — library call manual page, bestie ✨

Okay so you're in the library call manual and the star of the show is DtMmdbBookGetLongTitle, and she's here to get a book's long title. No cap. 💅

🌸 NAME 🌸

DtMmdbBookGetLongTitle — obtains the long title of a book. That's the whole assignment, and she ate. 👑

✨ SYNOPSIS ✨

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

💖 DESCRIPTION 💖

The DtMmdbBookGetLongTitle function returns the long title of the specified book object. 🦋

🚨 Bestie, do not use the free function on the returned pointer. Not me warning you about cleanup chaos — just don't. 🙈

Table lookup is involved when the identifier is specified by either the primary_oid or sequence_num field. That's the lowkey important part. ⭐

🧚 ARGUMENTS 🧚

• request — specifies the bookcase in the bookcase descriptor field, as well as a valid value in the primary_oid, the secondary_oid, or the sequence_num field. Here's the breakdown, iykyk:
  • primary_oid represents the DtInfo Database object identifier of the TOC section.
  • secondary_oid represents the object identifier of the book itself.
  • sequence_num represents the sequence number of the book within the bookcase, and it's 0 based. If more than one of these fields have a valid value, the order of precedence is: primary_oid, secondary_oid, and, last, sequence_num. Periodt. 👑
• length — specifies the variable to receive the length of the returned long title, if the returned pointer to the title is not NULL. Keeper of the length info, basically. 📏

🌈 RETURN VALUE 🌈

If DtMmdbBookGetLongTitle completes successfully, it returns a pointer to the book's long title. Slay. 💖 If it fails, it returns a NULL pointer. Sad girl hours. 😭

🍓 EXAMPLE 🍓

None. Literally none — the example section is serving minimalist icon energy, and we respect it. 🫶

💜 SEE ALSO 💜

• DtMmdbBookGetShortTitle(3) — go give the short-title sibling some love too. ✨

---

Cute sign-off time: the footer in the source is the library call manual entry for DtMmdbBookGetLongTitle, and no separate version or date line came with it — so that's the whole footer vibe, bestie. 🎀💅