FcFontSort(3)

💖 NAME 💖

Okay so welcome to the manual page for FcFontSort(3) bestie — this one is literally named FcFontSort, and its whole thing is return list of matching fonts. No cap, that's the name and the vibe. 🎀

✨ SYNOPSIS ✨

#include <fontconfig/fontconfig.h>

FcFontSet * FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result);

🌸 DESCRIPTION 🌸

So FcFontSort returns the list of fonts sorted by closeness to p. If trim is FcTrue, elements in the list which don't include Unicode coverage not provided by earlier elements in the list are elided — yep, elided, that's the word 😭. The union of Unicode coverage of all of the fonts is returned in csp, if csp is not NULL.

⚠️ Bestie, listen: this function should be called only after FcConfigSubstitute and FcDefaultSubstitute have been called for p; otherwise the results will not be correct. That's the warning, fr fr.

The returned FcFontSet references FcPattern structures which may be shared by the return value from multiple FcFontSort calls. Applications must not modify these patterns. Instead, they should be passed, along with p to FcFontRenderPrepare which combines them into a complete pattern.

The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy. If config is NULL, the current configuration is used.

---

Mwah 💅 this page is from Fontconfig 2.17.0, dated 27 June 2025 — k bye bestie, go sort those fonts 🫶✨