FcConfigFileInfoIterInit(3)

💖 NAME 💖

okay bestie, welcome to the FcConfigFileInfoIterInit(3) page — yep, this is section 3 of the fontconfig manual, and we're talking about FcConfigFileInfoIterInit, the function that initializes the iterator. it's giving "set it up so it starts at the very first one" energy, and honestly? slay. ✨

✨ SYNOPSIS ✨

#include <fontconfig/fontconfig.h>

void FcConfigFileInfoIterInit (FcConfig *config, FcConfigFileInfoIter *iter);

drop that include in and you're ready to call the function, no cap. 🫶

🦋 DESCRIPTION 🦋

okay so here's the tea: FcConfigFileInfoIterInit initializes iter with the first iterator in the config file information list. that's the whole mission — first one, right out the gate. 🎀

the config file information list is stored in numerical order for filenames — i.e. how fontconfig actually read them. so the order is not random, it's the actual read order, and that's lowkey iconic. 📚✨

⚠️ caveat time, and this one matters: this function isn't MT-safe. FcConfigReference must be called before using this, and then FcConfigDestroy when the relevant values are no longer referenced. no skipping that, fr fr. 💅

🎀 SINCE 🎀

this one has been around since version 2.12.91. vintage behavior, still relevant, we love to see it. 💜

---

that's the page, bestie. stay sparkly, keep your refs handled, and this was Fontconfig 2.17.0 dated 27 June 2025. mwah 💋✨