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.