fcconfigreference.html revision 1cc69409 
1a6844aabSmrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2a6844aabSmrg<HTML
3a6844aabSmrg><HEAD
4a6844aabSmrg><TITLE
5a6844aabSmrg>FcConfigReference</TITLE
6a6844aabSmrg><META
7a6844aabSmrgNAME="GENERATOR"
8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a6844aabSmrgREL="HOME"
10a6844aabSmrgHREF="t1.html"><LINK
11a6844aabSmrgREL="UP"
12a6844aabSmrgTITLE="FcConfig"
13a32e9e42SmrgHREF="x103.html#AEN3038"><LINK
14a6844aabSmrgREL="PREVIOUS"
15a6844aabSmrgTITLE="FcConfigCreate"
16a6844aabSmrgHREF="fcconfigcreate.html"><LINK
17a6844aabSmrgREL="NEXT"
18a6844aabSmrgTITLE="FcConfigDestroy"
19a6844aabSmrgHREF="fcconfigdestroy.html"></HEAD
20a6844aabSmrg><BODY
21a6844aabSmrgCLASS="REFENTRY"
22a6844aabSmrgBGCOLOR="#FFFFFF"
23a6844aabSmrgTEXT="#000000"
24a6844aabSmrgLINK="#0000FF"
25a6844aabSmrgVLINK="#840084"
26a6844aabSmrgALINK="#0000FF"
27a6844aabSmrg><DIV
28a6844aabSmrgCLASS="NAVHEADER"
29a6844aabSmrg><TABLE
30a6844aabSmrgSUMMARY="Header navigation table"
31a6844aabSmrgWIDTH="100%"
32a6844aabSmrgBORDER="0"
33a6844aabSmrgCELLPADDING="0"
34a6844aabSmrgCELLSPACING="0"
35a6844aabSmrg><TR
36a6844aabSmrg><TH
37a6844aabSmrgCOLSPAN="3"
38a6844aabSmrgALIGN="center"
39a6844aabSmrg></TH
40a6844aabSmrg></TR
41a6844aabSmrg><TR
42a6844aabSmrg><TD
43a6844aabSmrgWIDTH="10%"
44a6844aabSmrgALIGN="left"
45a6844aabSmrgVALIGN="bottom"
46a6844aabSmrg><A
47a6844aabSmrgHREF="fcconfigcreate.html"
48a6844aabSmrgACCESSKEY="P"
49a6844aabSmrg>&#60;&#60;&#60; Previous</A
50a6844aabSmrg></TD
51a6844aabSmrg><TD
52a6844aabSmrgWIDTH="80%"
53a6844aabSmrgALIGN="center"
54a6844aabSmrgVALIGN="bottom"
55a6844aabSmrg></TD
56a6844aabSmrg><TD
57a6844aabSmrgWIDTH="10%"
58a6844aabSmrgALIGN="right"
59a6844aabSmrgVALIGN="bottom"
60a6844aabSmrg><A
61a6844aabSmrgHREF="fcconfigdestroy.html"
62a6844aabSmrgACCESSKEY="N"
63a6844aabSmrg>Next &#62;&#62;&#62;</A
64a6844aabSmrg></TD
65a6844aabSmrg></TR
66a6844aabSmrg></TABLE
67a6844aabSmrg><HR
68a6844aabSmrgALIGN="LEFT"
69a6844aabSmrgWIDTH="100%"></DIV
70a6844aabSmrg><H1
71a6844aabSmrg><A
72a6844aabSmrgNAME="FCCONFIGREFERENCE"
73a6844aabSmrg></A
74a6844aabSmrg>FcConfigReference</H1
75a6844aabSmrg><DIV
76a6844aabSmrgCLASS="REFNAMEDIV"
77a6844aabSmrg><A
78a32e9e42SmrgNAME="AEN3065"
79a6844aabSmrg></A
80a6844aabSmrg><H2
81a6844aabSmrg>Name</H2
82a6844aabSmrg>FcConfigReference&nbsp;--&nbsp;Increment config reference count</DIV
83a6844aabSmrg><DIV
84a6844aabSmrgCLASS="REFSYNOPSISDIV"
85a6844aabSmrg><A
86a32e9e42SmrgNAME="AEN3068"
87a6844aabSmrg></A
88a6844aabSmrg><H2
89a6844aabSmrg>Synopsis</H2
90a6844aabSmrg><DIV
91a6844aabSmrgCLASS="FUNCSYNOPSIS"
92a6844aabSmrg><P
93a6844aabSmrg></P
94a6844aabSmrg><A
95a32e9e42SmrgNAME="AEN3069"
96a6844aabSmrg></A
97a6844aabSmrg><TABLE
98a6844aabSmrgBORDER="0"
99a6844aabSmrgBGCOLOR="#E0E0E0"
100a6844aabSmrgWIDTH="100%"
101a6844aabSmrg><TR
102a6844aabSmrg><TD
103a6844aabSmrg><PRE
104a6844aabSmrgCLASS="FUNCSYNOPSISINFO"
105c9710b42Smrg>#include &#60;fontconfig/fontconfig.h&#62;
1061cc69409Smrg        </PRE
107a6844aabSmrg></TD
108a6844aabSmrg></TR
109a6844aabSmrg></TABLE
110a6844aabSmrg><P
111a6844aabSmrg><CODE
112a6844aabSmrg><CODE
113a6844aabSmrgCLASS="FUNCDEF"
114a6844aabSmrg>FcConfig * <TT
115a6844aabSmrgCLASS="FUNCTION"
116a6844aabSmrg>FcConfigReference</TT
117a6844aabSmrg></CODE
118a6844aabSmrg>(FcConfig *<TT
119a6844aabSmrgCLASS="PARAMETER"
120a6844aabSmrg><I
121a6844aabSmrg>config</I
122a6844aabSmrg></TT
123a6844aabSmrg>);</CODE
124a6844aabSmrg></P
125a6844aabSmrg><P
126a6844aabSmrg></P
127a6844aabSmrg></DIV
128a6844aabSmrg></DIV
129a6844aabSmrg><DIV
130a6844aabSmrgCLASS="REFSECT1"
131a6844aabSmrg><A
132a32e9e42SmrgNAME="AEN3076"
133a6844aabSmrg></A
134a6844aabSmrg><H2
135a6844aabSmrg>Description</H2
136a6844aabSmrg><P
137a6844aabSmrg>Add another reference to <TT
138a6844aabSmrgCLASS="PARAMETER"
139a6844aabSmrg><I
140a6844aabSmrg>config</I
141a6844aabSmrg></TT
142a6844aabSmrg>. Configs are freed only
143a6844aabSmrgwhen the reference count reaches zero.
144a6844aabSmrgIf <TT
145a6844aabSmrgCLASS="PARAMETER"
146a6844aabSmrg><I
147a6844aabSmrg>config</I
148a6844aabSmrg></TT
149a6844aabSmrg> is NULL, the current configuration is used.
150a6844aabSmrgIn that case this function will be similar to FcConfigGetCurrent() except that
151a6844aabSmrgit increments the reference count before returning and the user is responsible
152a6844aabSmrgfor destroying the configuration when not needed anymore.
1531cc69409Smrg            </P
154a6844aabSmrg></DIV
155a6844aabSmrg><DIV
156a6844aabSmrgCLASS="NAVFOOTER"
157a6844aabSmrg><HR
158a6844aabSmrgALIGN="LEFT"
159a6844aabSmrgWIDTH="100%"><TABLE
160a6844aabSmrgSUMMARY="Footer navigation table"
161a6844aabSmrgWIDTH="100%"
162a6844aabSmrgBORDER="0"
163a6844aabSmrgCELLPADDING="0"
164a6844aabSmrgCELLSPACING="0"
165a6844aabSmrg><TR
166a6844aabSmrg><TD
167a6844aabSmrgWIDTH="33%"
168a6844aabSmrgALIGN="left"
169a6844aabSmrgVALIGN="top"
170a6844aabSmrg><A
171a6844aabSmrgHREF="fcconfigcreate.html"
172a6844aabSmrgACCESSKEY="P"
173a6844aabSmrg>&#60;&#60;&#60; Previous</A
174a6844aabSmrg></TD
175a6844aabSmrg><TD
176a6844aabSmrgWIDTH="34%"
177a6844aabSmrgALIGN="center"
178a6844aabSmrgVALIGN="top"
179a6844aabSmrg><A
180a6844aabSmrgHREF="t1.html"
181a6844aabSmrgACCESSKEY="H"
182a6844aabSmrg>Home</A
183a6844aabSmrg></TD
184a6844aabSmrg><TD
185a6844aabSmrgWIDTH="33%"
186a6844aabSmrgALIGN="right"
187a6844aabSmrgVALIGN="top"
188a6844aabSmrg><A
189a6844aabSmrgHREF="fcconfigdestroy.html"
190a6844aabSmrgACCESSKEY="N"
191a6844aabSmrg>Next &#62;&#62;&#62;</A
192a6844aabSmrg></TD
193a6844aabSmrg></TR
194a6844aabSmrg><TR
195a6844aabSmrg><TD
196a6844aabSmrgWIDTH="33%"
197a6844aabSmrgALIGN="left"
198a6844aabSmrgVALIGN="top"
199a6844aabSmrg>FcConfigCreate</TD
200a6844aabSmrg><TD
201a6844aabSmrgWIDTH="34%"
202a6844aabSmrgALIGN="center"
203a6844aabSmrgVALIGN="top"
204a6844aabSmrg><A
205a32e9e42SmrgHREF="x103.html#AEN3038"
206a6844aabSmrgACCESSKEY="U"
207a6844aabSmrg>Up</A
208a6844aabSmrg></TD
209a6844aabSmrg><TD
210a6844aabSmrgWIDTH="33%"
211a6844aabSmrgALIGN="right"
212a6844aabSmrgVALIGN="top"
213a6844aabSmrg>FcConfigDestroy</TD
214a6844aabSmrg></TR
215a6844aabSmrg></TABLE
216a6844aabSmrg></DIV
217a6844aabSmrg></BODY
218a6844aabSmrg></HTML
219a6844aabSmrg>