fcconfigreference.html revision b09479dc 
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>FcConfigReference</TITLE
6><META
7NAME="GENERATOR"
8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9REL="HOME"
10HREF="t1.html"><LINK
11REL="UP"
12TITLE="FcConfig"
13HREF="x102.html#AEN2562"><LINK
14REL="PREVIOUS"
15TITLE="FcConfigCreate"
16HREF="fcconfigcreate.html"><LINK
17REL="NEXT"
18TITLE="FcConfigDestroy"
19HREF="fcconfigdestroy.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="fcconfigcreate.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="fcconfigdestroy.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="FCCONFIGREFERENCE"
73></A
74>FcConfigReference</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN2589"
79></A
80><H2
81>Name</H2
82>FcConfigReference&nbsp;--&nbsp;Increment config reference count</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN2592"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN2593"
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>FcConfig * <TT
115CLASS="FUNCTION"
116>FcConfigReference</TT
117></CODE
118>(FcConfig *<TT
119CLASS="PARAMETER"
120><I
121>config</I
122></TT
123>);</CODE
124></P
125><P
126></P
127></DIV
128></DIV
129><DIV
130CLASS="REFSECT1"
131><A
132NAME="AEN2600"
133></A
134><H2
135>Description</H2
136><P
137>Add another reference to <TT
138CLASS="PARAMETER"
139><I
140>config</I
141></TT
142>. Configs are freed only
143when the reference count reaches zero.
144If <TT
145CLASS="PARAMETER"
146><I
147>config</I
148></TT
149> is NULL, the current configuration is used.
150In that case this function will be similar to FcConfigGetCurrent() except that
151it increments the reference count before returning and the user is responsible
152for destroying the configuration when not needed anymore.
153	    </P
154></DIV
155><DIV
156CLASS="NAVFOOTER"
157><HR
158ALIGN="LEFT"
159WIDTH="100%"><TABLE
160SUMMARY="Footer navigation table"
161WIDTH="100%"
162BORDER="0"
163CELLPADDING="0"
164CELLSPACING="0"
165><TR
166><TD
167WIDTH="33%"
168ALIGN="left"
169VALIGN="top"
170><A
171HREF="fcconfigcreate.html"
172ACCESSKEY="P"
173>&#60;&#60;&#60; Previous</A
174></TD
175><TD
176WIDTH="34%"
177ALIGN="center"
178VALIGN="top"
179><A
180HREF="t1.html"
181ACCESSKEY="H"
182>Home</A
183></TD
184><TD
185WIDTH="33%"
186ALIGN="right"
187VALIGN="top"
188><A
189HREF="fcconfigdestroy.html"
190ACCESSKEY="N"
191>Next &#62;&#62;&#62;</A
192></TD
193></TR
194><TR
195><TD
196WIDTH="33%"
197ALIGN="left"
198VALIGN="top"
199>FcConfigCreate</TD
200><TD
201WIDTH="34%"
202ALIGN="center"
203VALIGN="top"
204><A
205HREF="x102.html#AEN2562"
206ACCESSKEY="U"
207>Up</A
208></TD
209><TD
210WIDTH="33%"
211ALIGN="right"
212VALIGN="top"
213>FcConfigDestroy</TD
214></TR
215></TABLE
216></DIV
217></BODY
218></HTML
219>