1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<HTML
3><HEAD
4><TITLE
5>FcPatternBuild</TITLE
6><META
7NAME="GENERATOR"
8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9REL="HOME"
10HREF="t1.html"><LINK
11REL="UP"
12TITLE="FcPattern"
13HREF="x103.html#AEN242"><LINK
14REL="PREVIOUS"
15TITLE="FcPatternGet-Type"
16HREF="fcpatternget-type.html"><LINK
17REL="NEXT"
18TITLE="FcPatternDel"
19HREF="fcpatterndel.html"></HEAD
20><BODY
21CLASS="REFENTRY"
22BGCOLOR="#FFFFFF"
23TEXT="#000000"
24LINK="#0000FF"
25VLINK="#840084"
26ALINK="#0000FF"
27><DIV
28CLASS="NAVHEADER"
29><TABLE
30SUMMARY="Header navigation table"
31WIDTH="100%"
32BORDER="0"
33CELLPADDING="0"
34CELLSPACING="0"
35><TR
36><TH
37COLSPAN="3"
38ALIGN="center"
39></TH
40></TR
41><TR
42><TD
43WIDTH="10%"
44ALIGN="left"
45VALIGN="bottom"
46><A
47HREF="fcpatternget-type.html"
48ACCESSKEY="P"
49>&#60;&#60;&#60; Previous</A
50></TD
51><TD
52WIDTH="80%"
53ALIGN="center"
54VALIGN="bottom"
55></TD
56><TD
57WIDTH="10%"
58ALIGN="right"
59VALIGN="bottom"
60><A
61HREF="fcpatterndel.html"
62ACCESSKEY="N"
63>Next &#62;&#62;&#62;</A
64></TD
65></TR
66></TABLE
67><HR
68ALIGN="LEFT"
69WIDTH="100%"></DIV
70><H1
71><A
72NAME="FCPATTERNBUILD"
73></A
74>FcPatternBuild</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN785"
79></A
80><H2
81>Name</H2
82>FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild&nbsp;--&nbsp;Create patterns from arguments</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN790"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN791"
96></A
97><TABLE
98BORDER="0"
99BGCOLOR="#E0E0E0"
100WIDTH="100%"
101><TR
102><TD
103><PRE
104CLASS="FUNCSYNOPSISINFO"
105>#include &#60;fontconfig/fontconfig.h&#62;
106        </PRE
107></TD
108></TR
109></TABLE
110><P
111><CODE
112><CODE
113CLASS="FUNCDEF"
114>FcPattern * <TT
115CLASS="FUNCTION"
116>FcPatternBuild</TT
117></CODE
118>(FcPattern *<TT
119CLASS="PARAMETER"
120><I
121>pattern</I
122></TT
123>, ...<TT
124CLASS="PARAMETER"
125><I
126></I
127></TT
128>);</CODE
129></P
130><P
131><CODE
132><CODE
133CLASS="FUNCDEF"
134>FcPattern * <TT
135CLASS="FUNCTION"
136>FcPatternVaBuild</TT
137></CODE
138>(FcPattern *<TT
139CLASS="PARAMETER"
140><I
141>pattern</I
142></TT
143>, va_list <TT
144CLASS="PARAMETER"
145><I
146>va</I
147></TT
148>);</CODE
149></P
150><P
151><CODE
152><CODE
153CLASS="FUNCDEF"
154>void <TT
155CLASS="FUNCTION"
156>FcPatternVapBuild</TT
157></CODE
158>(FcPattern *<TT
159CLASS="PARAMETER"
160><I
161>result</I
162></TT
163>, FcPattern *<TT
164CLASS="PARAMETER"
165><I
166>pattern</I
167></TT
168>, va_list <TT
169CLASS="PARAMETER"
170><I
171>va</I
172></TT
173>);</CODE
174></P
175><P
176></P
177></DIV
178></DIV
179><DIV
180CLASS="REFSECT1"
181><A
182NAME="AEN816"
183></A
184><H2
185>Description</H2
186><P
187>Builds a pattern using a list of objects, types and values.  Each
188value to be entered in the pattern is specified with three arguments:</P
189><P
190></P
191><OL
192TYPE="1"
193><LI
194><P
195>Object name, a string describing the property to be added.</P
196></LI
197><LI
198><P
199>Object type, one of the FcType enumerated values</P
200></LI
201><LI
202><P
203>Value, not an FcValue, but the raw type as passed to any of the
204FcPatternAdd&#60;type&#62; functions.  Must match the type of the second
205argument.</P
206></LI
207></OL
208><P
209>The argument list is terminated by a null object name, no object type nor
210value need be passed for this.  The values are added to `pattern', if
211`pattern' is null, a new pattern is created.  In either case, the pattern is
212returned. Example</P
213><TABLE
214BORDER="0"
215BGCOLOR="#E0E0E0"
216WIDTH="100%"
217><TR
218><TD
219><PRE
220CLASS="PROGRAMLISTING"
221>pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);</PRE
222></TD
223></TR
224></TABLE
225><P
226>FcPatternVaBuild is used when the arguments are already in the form of a
227varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
228which returns its result directly in the <TT
229CLASS="PARAMETER"
230><I
231>result</I
232></TT
233>
234variable.
235            </P
236></DIV
237><DIV
238CLASS="NAVFOOTER"
239><HR
240ALIGN="LEFT"
241WIDTH="100%"><TABLE
242SUMMARY="Footer navigation table"
243WIDTH="100%"
244BORDER="0"
245CELLPADDING="0"
246CELLSPACING="0"
247><TR
248><TD
249WIDTH="33%"
250ALIGN="left"
251VALIGN="top"
252><A
253HREF="fcpatternget-type.html"
254ACCESSKEY="P"
255>&#60;&#60;&#60; Previous</A
256></TD
257><TD
258WIDTH="34%"
259ALIGN="center"
260VALIGN="top"
261><A
262HREF="t1.html"
263ACCESSKEY="H"
264>Home</A
265></TD
266><TD
267WIDTH="33%"
268ALIGN="right"
269VALIGN="top"
270><A
271HREF="fcpatterndel.html"
272ACCESSKEY="N"
273>Next &#62;&#62;&#62;</A
274></TD
275></TR
276><TR
277><TD
278WIDTH="33%"
279ALIGN="left"
280VALIGN="top"
281>FcPatternGet-Type</TD
282><TD
283WIDTH="34%"
284ALIGN="center"
285VALIGN="top"
286><A
287HREF="x103.html#AEN242"
288ACCESSKEY="U"
289>Up</A
290></TD
291><TD
292WIDTH="33%"
293ALIGN="right"
294VALIGN="top"
295>FcPatternDel</TD
296></TR
297></TABLE
298></DIV
299></BODY
300></HTML
301>