XMFONTLISTNEXTENTRY(3)

💖 XmFontListNextEntry 💖

okay so bestie, welcome to XmFontListNextEntry — a lil library call from the Xm font list family (yes, the (library call) one, we're fancy like that). she's the girl who walks down the font list one entry at a time and hands you the next one. no cap. 🎀

---

✨ NAME ✨

XmFontListNextEntry — a font list function that returns the next entry in a font list 🦋

---

✨ SYNOPSIS ✨

#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry(
XmFontContext context);

---

✨ DESCRIPTION ✨

so here's the tea ☕ — XmFontListNextEntry returns the next entry in the font list. like, she literally just hands you the next one. that's her whole job and she eats every time. 💅

the way it works: your app uses the XmFontListInitFontContext routine to create a font list context. that context is your lil bookmark 🔖. and the first call to XmFontListNextEntry sets that context to the first entry in the font list. iconic behavior, honestly.

after that, the application calls XmFontListNextEntry over and over again with the same context. each succeeding call accesses the next entry of the font list. it's giving "walk the whole list, one step at a time" and we're obsessed. 🚶♀️✨

and when you're done? when you've seen every single entry and you're full? the application calls XmFontListFreeFontContext to free the allocated font list context. clean up after yourself, queen. 🧹👑

• context — specifies the font list context. that's the lil bookmark we were talking about. 💜

---

✨ RETURN ✨

she returns NULL if the context does not refer to a valid entry or if it is at the end of the font list. so like, NULL = "nothing here bestie, we're done" 🚫

otherwise, she returns a font list entry. yay! 🎉

⚠️ okay important, and I mean important: if the function does return a font list entry, that font list entry is not a copy. so the application should not free the returned font list entry. do not free it. put the free() down. 🙈🚫 that's not yours to free, it belongs to the font list. periodt. 💀

---

✨ RELATED ✨

go check out her sisters, they're all serving 🔥:

• XmFontList(3)
• XmFontListEntryFree(3)
• XmFontListEntryGetFont(3)
• XmFontListEntryGetTag(3)
• XmFontListFreeFontContext(3)
• XmFontListInitFontContext(3)

---

and that's the whole page, bestie!! 🫶 this came to you straight from the XmFontListNextEntry(library call) manual, so you know it's legit. mwah 💋 go walk that font list, one entry at a time, and don't forget to free your context when you're done. slay ✨🌈💖