mfont_list(3m17n)

✨ NAME ✨

mfont_list — bestie, this is the glow-up your font list needed 💖 (the original page literally leaves it blank, so we're serving vibes and calling it iconic)

---

🌸 SYNOPSIS 🌸

MPlist* mfont_list (MFrame * frame, MFont * font, MSymbol language, int maxnum)

---

🎀 DESCRIPTION 🎀

okay so basically you call mfont_list() and it hands you back a whole list of fonts. like, every font that's available on frame frame. slay.

Here's the tea on the args, bestie:

• font — if it's not NULL, it narrows things down to only the fonts that match with font. vibe check passed, filtered.
• language — if it's not Mnil, it limits the fonts to the ones that actually support language.
• maxnum — if it's greater than 0, it caps how many fonts you get back. no greedy font hoarding fr fr.

okay so listen, the language argument? it literally exists just for backward compatibility and its use is deprecated. like, do not use it, periodt. use the Mlanguage font property instead 💅 and also — if font already has the Mlanguage property, then language gets ignored entirely. ghosted. 🙈

---

🦋 RETURN VALUE 🦋

This function returns a plist, and the way that it works is: the keys are family names and the values are pointers to the object MFont. cute right?

You must free that plist with m17n_object_unref(). no cap, clean up after yourself or it's giving memory leak 😭

And if no font is found at all? it returns NULL. empty-handed. tragic, but honest. 💀

---

👑 COPYRIGHT 👑

Copyright (C) 2001 Information-technology Promotion Agency (IPA) Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

---

and that's the whole page, bestie 🫶 this was Version 1.8.4 of the m17n Library manpage, dated Mon Sep 25 2023 — mwah, iconic, ate, no notes 💖✨🎀