fcpatternadd.html revision 1cc69409 
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>FcPatternAdd</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="FcPatternHash"
16HREF="fcpatternhash.html"><LINK
17REL="NEXT"
18TITLE="FcPatternAddWeak"
19HREF="fcpatternaddweak.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="fcpatternhash.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="fcpatternaddweak.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="FCPATTERNADD"
73></A
74>FcPatternAdd</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN444"
79></A
80><H2
81>Name</H2
82>FcPatternAdd&nbsp;--&nbsp;Add a value to a pattern</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN447"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN448"
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>FcBool <TT
115CLASS="FUNCTION"
116>FcPatternAdd</TT
117></CODE
118>(FcPattern *<TT
119CLASS="PARAMETER"
120><I
121>p</I
122></TT
123>, const char *<TT
124CLASS="PARAMETER"
125><I
126>object</I
127></TT
128>, FcValue <TT
129CLASS="PARAMETER"
130><I
131>value</I
132></TT
133>, FcBool <TT
134CLASS="PARAMETER"
135><I
136>append</I
137></TT
138>);</CODE
139></P
140><P
141></P
142></DIV
143></DIV
144><DIV
145CLASS="REFSECT1"
146><A
147NAME="AEN461"
148></A
149><H2
150>Description</H2
151><P
152>Adds a single value to the list of values associated with the property named
153`object<TT
154CLASS="PARAMETER"
155><I
156>.  If `append</I
157></TT
158> is FcTrue, the value is added at the end of any
159existing list, otherwise it is inserted at the beginning.  `value' is saved
160(with FcValueSave) when inserted into the pattern so that the library
161retains no reference to any application-supplied data structure.
162            </P
163></DIV
164><DIV
165CLASS="NAVFOOTER"
166><HR
167ALIGN="LEFT"
168WIDTH="100%"><TABLE
169SUMMARY="Footer navigation table"
170WIDTH="100%"
171BORDER="0"
172CELLPADDING="0"
173CELLSPACING="0"
174><TR
175><TD
176WIDTH="33%"
177ALIGN="left"
178VALIGN="top"
179><A
180HREF="fcpatternhash.html"
181ACCESSKEY="P"
182>&#60;&#60;&#60; Previous</A
183></TD
184><TD
185WIDTH="34%"
186ALIGN="center"
187VALIGN="top"
188><A
189HREF="t1.html"
190ACCESSKEY="H"
191>Home</A
192></TD
193><TD
194WIDTH="33%"
195ALIGN="right"
196VALIGN="top"
197><A
198HREF="fcpatternaddweak.html"
199ACCESSKEY="N"
200>Next &#62;&#62;&#62;</A
201></TD
202></TR
203><TR
204><TD
205WIDTH="33%"
206ALIGN="left"
207VALIGN="top"
208>FcPatternHash</TD
209><TD
210WIDTH="34%"
211ALIGN="center"
212VALIGN="top"
213><A
214HREF="x103.html#AEN242"
215ACCESSKEY="U"
216>Up</A
217></TD
218><TD
219WIDTH="33%"
220ALIGN="right"
221VALIGN="top"
222>FcPatternAddWeak</TD
223></TR
224></TABLE
225></DIV
226></BODY
227></HTML
228>