FcPatternIterNext(3)

💅 FcPatternIterNext(3) — your girl's guide to stepping thru a pattern iterator

okay so first things first, bestie: this page is literally called FcPatternIterNext, and the manual name for it is FcPatternIterNext(3) — that's the 3 in the corner, meaning "C library function," iykyk. yes the NAME section in the original is just the name with a dash and nothing after it, no cap, it's giving mysterious main character energy and we respect that. 🎀

---

✨ SYNOPSIS ✨

pull in the header like so, bestie:

#include <fontconfig/fontconfig.h>

and here's the function signature, exactly as it lives, don't come for me:

FcBool FcPatternIterNext (const FcPattern *p, FcPatternIter *iter);

---

🌸 DESCRIPTION 🌸

okay so what does it do, right? it sets iter to point to the next object in p 💫 — and if it succeeded in moving iter along to that next object, it hands you back FcTrue. that's the slay. ✅

and otherwise? it returns FcFalse. that's the whole vibe — no next object for you, bestie, iterator's done. 💀 so basically FcTrue = "yes queen, you moved," FcFalse = "nope, that was the end of the line." 🙈

🫶 tiny note on the wording: the manpage literally says "Set iter to point to the next object in p and returns FcTrue if iter has been changed to the next object. returns FcFalse otherwise." so like, the return value is telling you whether the change actually happened. cute, right?

---

🦋 SINCE 🦋

this lil cutie has been around since version 2.13.1 ⭐ — so if you're on something older, sorry babe, she's not there yet.

---

and that's the whole page, honestly, short and iconic 💅✨ nothing else to report, no extra options, no env vars, no bugs to warn you about — just a clean lil iterator stepper doing its thing. go forth and iterate, bestie 🧚💜

Fontconfig 2.17.0 🌈 27 June 2025 — mwah, that's the version and date from the footer, love that for us. 🍓👑