FcFontSort(3) FcFontSort(3)

NAME

FcFontSort - Return list of matching fonts

SYNOPSIS

#include <fontconfig/fontconfig.h>

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

DESCRIPTION

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. The union of
Unicode coverage of all of the fonts is returned in csp, if csp is
not NULL. This function should be called only after
FcConfigSubstitute and FcDefaultSubstitute have been called for p;
otherwise the results will not be correct.

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.

Fontconfig 2.15.0 22 12<?> 2023 FcFontSort(3)