FcPatternBuild.3 revision 2c393a42
This manpage has been automatically generated by docbook2man
from a DocBook document. This tool can be found at:
<http://shell.ipoline.com/~elmert/comp/docbook2X/>
Please send any bug reports, improvements, comments, patches,
etc. to Steve Cheng <steve@ggi-project.org>.
"FcPatternBuild" "3" "31 May 2008" "" ""
NAME
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild - Create patterns from arguments
SYNOPSIS
#include <fontconfig.h> FcPattern * FcPatternBuild (FcPattern *orig, ...); FcPattern * FcPatternVaBuild (FcPattern *orig, va_list va); void FcPatternVapBuild (FcPattern *result, FcPattern *orig, 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:

3 1. Object name, a string describing the property to be added.

3 2. Object type, one of the FcType enumerated values

3 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 FcPatternVaBuild which returns its result directly in the result variable.

"VERSION"

Fontconfig version 2.6.0