FcFontSort - Return list of matching fonts
#include <fontconfig/fontconfig.h> FcFontSet * FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result);
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
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 FcFontSort(3)