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                                 31 March 2024                                    FcFontSort(3)