FcPatternBuild.3 revision a6844aab 
1.\\" auto-generated by docbook2man-spec $Revision: 1.1.1.2 $
2.TH "FcPatternBuild" "3" "18 November 2009" "" ""
3.SH NAME
4FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild \- Create patterns from arguments
5.SH SYNOPSIS
6.nf
7\fB#include <fontconfig.h>
8.sp
9FcPattern * FcPatternBuild(FcPattern *\fIpattern\fB);
10(\&...\fI\fB);
11.sp
12FcPattern * FcPatternVaBuild(FcPattern *\fIpattern\fB);
13(va_list \fIva\fB);
14.sp
15void FcPatternVapBuild(FcPattern *\fIresult\fB);
16(FcPattern *\fIpattern\fB);
17(va_list \fIva\fB);
18\fR.fi
19.SH "DESCRIPTION"
20.PP
21Builds a pattern using a list of objects, types and values. Each
22value to be entered in the pattern is specified with three arguments:
23.IP 1. 
24Object name, a string describing the property to be added.
25.IP 2. 
26Object type, one of the FcType enumerated values
27.IP 3. 
28Value, not an FcValue, but the raw type as passed to any of the
29FcPatternAdd<type> functions. Must match the type of the second
30argument.
31.PP
32The argument list is terminated by a null object name, no object type nor
33value need be passed for this. The values are added to `pattern', if
34`pattern' is null, a new pattern is created. In either case, the pattern is
35returned. Example
36.PP
37.sp
38.nf
39pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
40.sp
41.fi
42.PP
43FcPatternVaBuild is used when the arguments are already in the form of a
44varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
45which returns its result directly in the \fIresult\fR
46variable.
47.PP
48.SH "VERSION"
49.PP
50Fontconfig version 2.8.0
51