FcPatternBuild - Create patterns from arguments
#include <fontconfig/fontconfig.h> FcPattern * FcPatternBuild (FcPattern *pattern, ...); FcPattern * FcPatternVaBuild (FcPattern *pattern, va_list va); void FcPatternVapBuild (FcPattern *result, FcPattern *pattern, va_list va);
FcPatternBuild(3) FcPatternBuild(3)
NAME
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild - Create patterns
from arguments
SYNOPSIS
#include <fontconfig/fontconfig.h>
FcPattern * FcPatternBuild (FcPattern *pattern, ...);
FcPattern * FcPatternVaBuild (FcPattern *pattern, va_list va);
void FcPatternVapBuild (FcPattern *result, FcPattern *pattern, va_list va);
DESCRIPTION
Builds a pattern using a list of objects, types and values. Each value
to be entered in the pattern is specified with three arguments:
1. Object name, a string describing the property to be added.
2. Object type, one of the FcType enumerated values
3. Value, not an FcValue, but the raw type as passed to any of the
FcPatternAdd<type> functions. Must match the type of the second
argument.
The argument list is terminated by a null object name, no object type
nor value need be passed for this. The values are added to `pattern',
if `pattern' is null, a new pattern is created. In either case, the
pattern is returned. Example
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
FcPatternVaBuild is used when the arguments are already in the form of
a varargs value. FcPatternVapBuild is a macro version of FcPat-
ternVaBuild which returns its result directly in the result variable.
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 FcPatternBuild(3)