FcPatternBuild(3)FcPatternBuild(3)NAME
FcPatternBuild, FcPatternVaBuild - Create patterns from
arguments
SYNOPSIS
#include <fontconfig.h>
FcPattern * FcPatternBuild (FcPattern *orig, ...);
FcPattern * FcPatternVaBuild (FcPattern *orig, va_listva);
DESCRIPTION
Builds a pattern using a list of objects, types and val-
ues. 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 pat-
tern is created. In either case, the pattern is returned.
Example
pattern = FcPatternBuild (0, FC_FAMILY, FtTypeString, "Times", (char *) 0);
FcPatternVaBuild is used when the arguments are already in
the form of a varargs value.
VERSION
Fontconfig version 2.2.0
21 April 2003 FcPatternBuild(3)