FcFontList(3)

✨ FcFontList — like, the font-listing icon 💅

okay so bestie, first things first: this page is from the FcFontList(3) manual, and it's genuinely one of the most useful little cuties in the whole fontconfig girlie universe. let's get into it 🎀

---

🌸 NAME 🌸

FcFontList — literally just "list fonts". that's it. that's the whole job. and she ate 💖

---

✨ SYNOPSIS ✨

#include <fontconfig/fontconfig.h>

FcFontSet * FcFontList (FcConfig *config, FcPattern *p, FcObjectSet *os);

like yes, that's the whole signature. three args, one FcFontSet * coming back at you. no cap 🦋

---

💜 DESCRIPTION 💜

okay so here's the vibe: FcFontList selects the fonts that match p, then it creates patterns from those fonts that contain only the objects in os, and then it returns the set of unique such patterns. unique is doing a lot of work in that sentence, so like, don't sleep on it 👑

and the config situation, because this is the part people always ask about in the group chat: if config is NULL, then the default configuration is checked to be up to date, and used. that's it. that's the whole deal. she's not mysterious, she's just efficient 🫶

nerd note (affectionate): the patterns you get back are not the full font patterns — they're trimmed down to just the objects in os. so if your fav object isn't in there, it's not coming back. choose your FcObjectSet like you mean it 💀

---

⭐ the whole thing in one breath ⭐

• pass in a config (or NULL → default config, freshness-checked, then used ✨)
• pass in p → the pattern your fonts need to match
• pass in os → the objects that survive into the output patterns
• get back an FcFontSet * of the unique resulting patterns

periodt. that's the function 🌈

---

🧚 sign-off 🧚

and that's the page, bestie!! this one's from Fontconfig 2.17.0, dated 27 June 2025 — go forth and list some fonts, you absolute main character 🍓💖✨