FcFontSort(3) FcFontSort(3)

NAME FcFontSort - Return list of matching fonts

SYNOPSIS #include <fontconfig.h>

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

DESCRIPTION Returns the list of fonts sorted by closeness to p. If trim is FcTrue, elements in the list which dont include Unicode coverage not provided by earlier elements in the list are elided. The union of Unicode cov- erage of all of the fonts is returned in csp, if csp is not NULL. This function should be called only after FcConfigSubstitute and FcDefault- Substitute 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 pat- tern.

The FcFontSet returned by FcFontSort is destroyed by caling FcFontSet- Destroy.

VERSION Fontconfig version 2.4.1

15 September 2006 FcFontSort(3)