Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

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 cover-
       age 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 calling FcFontSet-
       Destroy.  If config is NULL, the current configuration is used.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | system/library/fontconfig |
       +---------------+---------------------------+
       |Stability      | Volatile                  |
       +---------------+---------------------------+
NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   https://fontconfig.org/release/fontcon-
       fig-2.12.1.tar.bz2

       Further information about this software can be found on the open source
       community website at https://fontconfig.org/.



Fontconfig 2.12.1                  05 8 2016                     FcFontSort(3)