Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

FcFontSetSort (3)

Name

FcFontSetSort - Add to a font set

Synopsis

#include <fontconfig/fontconfig.h>

FcFontSet * FcFontSetSort (FcConfig *config, FcFontSet **sets, intnsets, FcPattern *pattern, FcBool trim, FcCharSet **csp, FcResult *result);

Description

FcFontSetSort(3)                                              FcFontSetSort(3)



NAME
       FcFontSetSort - Add to a font set

SYNOPSIS
       #include <fontconfig/fontconfig.h>

       FcFontSet * FcFontSetSort (FcConfig *config, FcFontSet **sets, intnsets, FcPattern *pattern, FcBool trim, FcCharSet **csp, FcResult *result);

DESCRIPTION
       Returns the list of fonts from sets sorted by closeness to pattern.  If
       trim is FcTrue, elements in the list which don't include Unicode cover-
       age  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
       cannot  modify  these  patterns.  Instead, they should be passed, along
       with pattern to FcFontRenderPrepare which combines them into a complete
       pattern.

       The  FcFontSet  returned  by  FcFontSetSort  is  destroyed  by  calling
       FcFontSetDestroy.



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


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | system/library/fontconfig |
       +---------------+---------------------------+
       |Stability      | Volatile                  |
       +---------------+---------------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       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.14.0.tar.xz.

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



Fontconfig 2.14.0                  31 3 2022                  FcFontSetSort(3)