fontconfig (2.14.2)
Browse
Usage
VersionsFcPatternBuild(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 val‐
ues are added to ‘pattern', if ‘pattern' is null, a new pattern is created. In either case, the pattern is re‐
turned. 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 FcPatternVaBuild which returns its result directly in the result variable.
Fontconfig 2.14.2 27 1月 2023 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 val‐
ues are added to ‘pattern', if ‘pattern' is null, a new pattern is created. In either case, the pattern is re‐
turned. 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 FcPatternVaBuild which returns its result directly in the result variable.
Fontconfig 2.14.2 27 1月 2023 FcPatternBuild(3)