XMFONTLISTENTRYCREATE(3)

✨ XmFontListEntryCreate ✨

okay bestie, gather round, because we're doing the library call thing today — this is XmFontListEntryCreate from the Xm fam, and she's literally the girl who makes font list entries. no cap. 💅

---

🎀 NAME 🎀

XmFontListEntryCreate — a font list function that creates a font list entry. that's it, that's the job, and she eats every time. 🔥

---

🦋 SYNOPSIS 🦋

#include <Xm/Xm.h>
XmFontListEntry XmFontListEntryCreate(
char *tag,
XmFontType type,
XtPointer font);

look at her. three little args. so demure, so mindful. 💖

---

🌸 DESCRIPTION 🌸

XmFontListEntryCreate creates a font list entry that contains either a font or font set, and it's identified by a tag. like, she's handing you a lil labeled box and you're like "slay, ty." ✨

• tag — Specifies a NULL terminated string for the tag of the font list entry. The tag may be specified as XmFONTLIST_DEFAULT_TAG, which is used to identify the default font list element in a font list. (iykyk, that's the "main character" tag of the whole list. 👑)
• type — Specifies whether the font argument is a font structure or a font set. Valid values are XmFONT_IS_FONT and XmFONT_IS_FONTSET. vibe check the type, bestie, don't just guess. 🌈
• font — Specifies either an XFontSet returned by XCreateFontSet or a pointer to an XFontStruct returned by XLoadQueryFont. 🍓

⚠️ okay this part is IMPORTANT, fr fr, do not skip: The toolkit does not copy the X Font structure specified by the font argument. Therefore, an application programmer must not free XFontStruct or XFontSet until all font lists and/or font entries that reference it have been freed. like, do not touch her until everybody's done with her, periodt. 💀

---

💜 RETURN 💜

Returns a font list entry. The function allocates space to hold the returned font list entry. The application is responsible for managing the allocated space. The application can recover the allocated space by calling XmFontListEntryFree. so she gives you a gift AND she gives you the receipt — iconic behavior, honestly. 🫶

---

⭐ RELATED ⭐

the girlies she hangs out with, all (3)s:

• XmFontList(3)
• XmFontListAppendEntry(3)
• XmFontListEntryFree(3)
• XmFontListEntryGetFont(3)
• XmFontListEntryGetTag(3)
• XmFontListEntryLoad(3)
• XmFontListRemoveEntry(3)

---

and that's the whole page, bestie!! 🌟 she lives under the XmFontListEntryCreate(library call) banner top and bottom — same name up top, same name at the sign-off, no date or version drama on this one, just the page title holding it down twice. mwah. 💅💖🧚