fcconfigreference.html revision c9710b42
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#AEN2679"><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><<< 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 >>></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="AEN2707" 79></A 80><H2 81>Name</H2 82>FcConfigReference -- Increment config reference count</DIV 83><DIV 84CLASS="REFSYNOPSISDIV" 85><A 86NAME="AEN2710" 87></A 88><H2 89>Synopsis</H2 90><DIV 91CLASS="FUNCSYNOPSIS" 92><P 93></P 94><A 95NAME="AEN2711" 96></A 97><TABLE 98BORDER="0" 99BGCOLOR="#E0E0E0" 100WIDTH="100%" 101><TR 102><TD 103><PRE 104CLASS="FUNCSYNOPSISINFO" 105>#include <fontconfig/fontconfig.h> 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="AEN2718" 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="REFSECT1" 157><A 158NAME="AEN2723" 159></A 160><H2 161>Version</H2 162><P 163>Fontconfig version 2.10.93 164 165 </P 166></DIV 167><DIV 168CLASS="NAVFOOTER" 169><HR 170ALIGN="LEFT" 171WIDTH="100%"><TABLE 172SUMMARY="Footer navigation table" 173WIDTH="100%" 174BORDER="0" 175CELLPADDING="0" 176CELLSPACING="0" 177><TR 178><TD 179WIDTH="33%" 180ALIGN="left" 181VALIGN="top" 182><A 183HREF="fcconfigcreate.html" 184ACCESSKEY="P" 185><<< Previous</A 186></TD 187><TD 188WIDTH="34%" 189ALIGN="center" 190VALIGN="top" 191><A 192HREF="t1.html" 193ACCESSKEY="H" 194>Home</A 195></TD 196><TD 197WIDTH="33%" 198ALIGN="right" 199VALIGN="top" 200><A 201HREF="fcconfigdestroy.html" 202ACCESSKEY="N" 203>Next >>></A 204></TD 205></TR 206><TR 207><TD 208WIDTH="33%" 209ALIGN="left" 210VALIGN="top" 211>FcConfigCreate</TD 212><TD 213WIDTH="34%" 214ALIGN="center" 215VALIGN="top" 216><A 217HREF="x102.html#AEN2679" 218ACCESSKEY="U" 219>Up</A 220></TD 221><TD 222WIDTH="33%" 223ALIGN="right" 224VALIGN="top" 225>FcConfigDestroy</TD 226></TR 227></TABLE 228></DIV 229></BODY 230></HTML 231>