Imported Upstream version 2.14.2
[platform/upstream/fontconfig.git] / doc / fontconfig-devel / fcconfigsubstitutewithpat.html
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 >FcConfigSubstituteWithPat</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 HREF="t1.html"><LINK
11 REL="UP"
12 TITLE="FcConfig"
13 HREF="x103.html#AEN3038"><LINK
14 REL="PREVIOUS"
15 TITLE="FcConfigAppFontClear"
16 HREF="fcconfigappfontclear.html"><LINK
17 REL="NEXT"
18 TITLE="FcConfigSubstitute"
19 HREF="fcconfigsubstitute.html"></HEAD
20 ><BODY
21 CLASS="REFENTRY"
22 BGCOLOR="#FFFFFF"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 SUMMARY="Header navigation table"
31 WIDTH="100%"
32 BORDER="0"
33 CELLPADDING="0"
34 CELLSPACING="0"
35 ><TR
36 ><TH
37 COLSPAN="3"
38 ALIGN="center"
39 ></TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="10%"
44 ALIGN="left"
45 VALIGN="bottom"
46 ><A
47 HREF="fcconfigappfontclear.html"
48 ACCESSKEY="P"
49 >&#60;&#60;&#60; Previous</A
50 ></TD
51 ><TD
52 WIDTH="80%"
53 ALIGN="center"
54 VALIGN="bottom"
55 ></TD
56 ><TD
57 WIDTH="10%"
58 ALIGN="right"
59 VALIGN="bottom"
60 ><A
61 HREF="fcconfigsubstitute.html"
62 ACCESSKEY="N"
63 >Next &#62;&#62;&#62;</A
64 ></TD
65 ></TR
66 ></TABLE
67 ><HR
68 ALIGN="LEFT"
69 WIDTH="100%"></DIV
70 ><H1
71 ><A
72 NAME="FCCONFIGSUBSTITUTEWITHPAT"
73 ></A
74 >FcConfigSubstituteWithPat</H1
75 ><DIV
76 CLASS="REFNAMEDIV"
77 ><A
78 NAME="AEN3482"
79 ></A
80 ><H2
81 >Name</H2
82 >FcConfigSubstituteWithPat&nbsp;--&nbsp;Execute substitutions</DIV
83 ><DIV
84 CLASS="REFSYNOPSISDIV"
85 ><A
86 NAME="AEN3485"
87 ></A
88 ><H2
89 >Synopsis</H2
90 ><DIV
91 CLASS="FUNCSYNOPSIS"
92 ><P
93 ></P
94 ><A
95 NAME="AEN3486"
96 ></A
97 ><TABLE
98 BORDER="0"
99 BGCOLOR="#E0E0E0"
100 WIDTH="100%"
101 ><TR
102 ><TD
103 ><PRE
104 CLASS="FUNCSYNOPSISINFO"
105 >#include &#60;fontconfig/fontconfig.h&#62;
106         </PRE
107 ></TD
108 ></TR
109 ></TABLE
110 ><P
111 ><CODE
112 ><CODE
113 CLASS="FUNCDEF"
114 >FcBool <TT
115 CLASS="FUNCTION"
116 >FcConfigSubstituteWithPat</TT
117 ></CODE
118 >(FcConfig *<TT
119 CLASS="PARAMETER"
120 ><I
121 >config</I
122 ></TT
123 >, FcPattern *<TT
124 CLASS="PARAMETER"
125 ><I
126 >p</I
127 ></TT
128 >, FcPattern *<TT
129 CLASS="PARAMETER"
130 ><I
131 >p_pat</I
132 ></TT
133 >, FcMatchKind <TT
134 CLASS="PARAMETER"
135 ><I
136 >kind</I
137 ></TT
138 >);</CODE
139 ></P
140 ><P
141 ></P
142 ></DIV
143 ></DIV
144 ><DIV
145 CLASS="REFSECT1"
146 ><A
147 NAME="AEN3499"
148 ></A
149 ><H2
150 >Description</H2
151 ><P
152 >Performs the sequence of pattern modification operations, if <TT
153 CLASS="PARAMETER"
154 ><I
155 >kind</I
156 ></TT
157 > is
158 FcMatchPattern, then those tagged as pattern operations are applied, else
159 if <TT
160 CLASS="PARAMETER"
161 ><I
162 >kind</I
163 ></TT
164 > is FcMatchFont, those tagged as font operations are applied and
165 p_pat is used for &#60;test&#62; elements with target=pattern. Returns FcFalse
166 if the substitution cannot be performed (due to allocation failure). Otherwise returns FcTrue.
167 If <TT
168 CLASS="PARAMETER"
169 ><I
170 >config</I
171 ></TT
172 > is NULL, the current configuration is used.
173             </P
174 ></DIV
175 ><DIV
176 CLASS="NAVFOOTER"
177 ><HR
178 ALIGN="LEFT"
179 WIDTH="100%"><TABLE
180 SUMMARY="Footer navigation table"
181 WIDTH="100%"
182 BORDER="0"
183 CELLPADDING="0"
184 CELLSPACING="0"
185 ><TR
186 ><TD
187 WIDTH="33%"
188 ALIGN="left"
189 VALIGN="top"
190 ><A
191 HREF="fcconfigappfontclear.html"
192 ACCESSKEY="P"
193 >&#60;&#60;&#60; Previous</A
194 ></TD
195 ><TD
196 WIDTH="34%"
197 ALIGN="center"
198 VALIGN="top"
199 ><A
200 HREF="t1.html"
201 ACCESSKEY="H"
202 >Home</A
203 ></TD
204 ><TD
205 WIDTH="33%"
206 ALIGN="right"
207 VALIGN="top"
208 ><A
209 HREF="fcconfigsubstitute.html"
210 ACCESSKEY="N"
211 >Next &#62;&#62;&#62;</A
212 ></TD
213 ></TR
214 ><TR
215 ><TD
216 WIDTH="33%"
217 ALIGN="left"
218 VALIGN="top"
219 >FcConfigAppFontClear</TD
220 ><TD
221 WIDTH="34%"
222 ALIGN="center"
223 VALIGN="top"
224 ><A
225 HREF="x103.html#AEN3038"
226 ACCESSKEY="U"
227 >Up</A
228 ></TD
229 ><TD
230 WIDTH="33%"
231 ALIGN="right"
232 VALIGN="top"
233 >FcConfigSubstitute</TD
234 ></TR
235 ></TABLE
236 ></DIV
237 ></BODY
238 ></HTML
239 >