FcFontSetMatch(3)

FcFontSetMatch3

Return the best font from a set of font sets

Usage

#include <fontconfig/fontconfig.h>

FcPattern * FcFontSetMatch (FcConfig *config, FcFontSet **sets, int nsets, FcPattern *pattern, FcResult *result);

Overview

Finds the font in sets most closely matching pattern and returns the result of FcFontRenderPrepare for that font and the provided pattern. This function should be called only after FcConfigSubstitute and FcDefaultSubstitute have been called for pattern; otherwise the results will not be correct. If config is NULL, the current configuration is used. Returns NULL if an error occurs during this process.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 8 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8–9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

From fontconfig 2:2.18.3-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.