fcconfiggetfilename.html revision 1cc69409 
1a4e54154Smrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2a4e54154Smrg<HTML
3a4e54154Smrg><HEAD
4a4e54154Smrg><TITLE
5a4e54154Smrg>FcConfigGetFilename</TITLE
6a4e54154Smrg><META
7a4e54154SmrgNAME="GENERATOR"
8a4e54154SmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a4e54154SmrgREL="HOME"
10a4e54154SmrgHREF="t1.html"><LINK
11a4e54154SmrgREL="UP"
12a4e54154SmrgTITLE="FcConfig"
13a4e54154SmrgHREF="x103.html#AEN3038"><LINK
14a4e54154SmrgREL="PREVIOUS"
15a4e54154SmrgTITLE="FcConfigFilename"
16a4e54154SmrgHREF="fcconfigfilename.html"><LINK
17a4e54154SmrgREL="NEXT"
18a4e54154SmrgTITLE="FcConfigParseAndLoad"
19a4e54154SmrgHREF="fcconfigparseandload.html"></HEAD
20a4e54154Smrg><BODY
21a4e54154SmrgCLASS="REFENTRY"
22a4e54154SmrgBGCOLOR="#FFFFFF"
23a4e54154SmrgTEXT="#000000"
24a4e54154SmrgLINK="#0000FF"
25a4e54154SmrgVLINK="#840084"
26a4e54154SmrgALINK="#0000FF"
27a4e54154Smrg><DIV
28a4e54154SmrgCLASS="NAVHEADER"
29a4e54154Smrg><TABLE
30a4e54154SmrgSUMMARY="Header navigation table"
31a4e54154SmrgWIDTH="100%"
32a4e54154SmrgBORDER="0"
33a4e54154SmrgCELLPADDING="0"
34a4e54154SmrgCELLSPACING="0"
35a4e54154Smrg><TR
36a4e54154Smrg><TH
37a4e54154SmrgCOLSPAN="3"
38a4e54154SmrgALIGN="center"
39a4e54154Smrg></TH
40a4e54154Smrg></TR
41a4e54154Smrg><TR
42a4e54154Smrg><TD
43a4e54154SmrgWIDTH="10%"
44a4e54154SmrgALIGN="left"
45a4e54154SmrgVALIGN="bottom"
46a4e54154Smrg><A
47a4e54154SmrgHREF="fcconfigfilename.html"
48a4e54154SmrgACCESSKEY="P"
49a4e54154Smrg>&#60;&#60;&#60; Previous</A
50a4e54154Smrg></TD
51a4e54154Smrg><TD
52a4e54154SmrgWIDTH="80%"
53a4e54154SmrgALIGN="center"
54a4e54154SmrgVALIGN="bottom"
55a4e54154Smrg></TD
56a4e54154Smrg><TD
57a4e54154SmrgWIDTH="10%"
58a4e54154SmrgALIGN="right"
59a4e54154SmrgVALIGN="bottom"
60a4e54154Smrg><A
61a4e54154SmrgHREF="fcconfigparseandload.html"
62a4e54154SmrgACCESSKEY="N"
63a4e54154Smrg>Next &#62;&#62;&#62;</A
64a4e54154Smrg></TD
65a4e54154Smrg></TR
66a4e54154Smrg></TABLE
67a4e54154Smrg><HR
68a4e54154SmrgALIGN="LEFT"
69a4e54154SmrgWIDTH="100%"></DIV
70a4e54154Smrg><H1
71a4e54154Smrg><A
72a4e54154SmrgNAME="FCCONFIGGETFILENAME"
73a4e54154Smrg></A
74a4e54154Smrg>FcConfigGetFilename</H1
75a4e54154Smrg><DIV
76a4e54154SmrgCLASS="REFNAMEDIV"
77a4e54154Smrg><A
78a4e54154SmrgNAME="AEN3676"
79a4e54154Smrg></A
80a4e54154Smrg><H2
81a4e54154Smrg>Name</H2
82a4e54154Smrg>FcConfigGetFilename&nbsp;--&nbsp;Find a config file</DIV
83a4e54154Smrg><DIV
84a4e54154SmrgCLASS="REFSYNOPSISDIV"
85a4e54154Smrg><A
86a4e54154SmrgNAME="AEN3679"
87a4e54154Smrg></A
88a4e54154Smrg><H2
89a4e54154Smrg>Synopsis</H2
90a4e54154Smrg><DIV
91a4e54154SmrgCLASS="FUNCSYNOPSIS"
92a4e54154Smrg><P
93a4e54154Smrg></P
94a4e54154Smrg><A
95a4e54154SmrgNAME="AEN3680"
96a4e54154Smrg></A
97a4e54154Smrg><TABLE
98a4e54154SmrgBORDER="0"
99a4e54154SmrgBGCOLOR="#E0E0E0"
100a4e54154SmrgWIDTH="100%"
101a4e54154Smrg><TR
102a4e54154Smrg><TD
103a4e54154Smrg><PRE
104a4e54154SmrgCLASS="FUNCSYNOPSISINFO"
105a4e54154Smrg>#include &#60;fontconfig/fontconfig.h&#62;
1061cc69409Smrg        </PRE
107a4e54154Smrg></TD
108a4e54154Smrg></TR
109a4e54154Smrg></TABLE
110a4e54154Smrg><P
111a4e54154Smrg><CODE
112a4e54154Smrg><CODE
113a4e54154SmrgCLASS="FUNCDEF"
114a4e54154Smrg>FcChar8 * <TT
115a4e54154SmrgCLASS="FUNCTION"
116a4e54154Smrg>FcConfigGetFilename</TT
117a4e54154Smrg></CODE
118a4e54154Smrg>(FcConfig *<TT
119a4e54154SmrgCLASS="PARAMETER"
120a4e54154Smrg><I
121a4e54154Smrg>config</I
122a4e54154Smrg></TT
123a4e54154Smrg>, const FcChar8 *<TT
124a4e54154SmrgCLASS="PARAMETER"
125a4e54154Smrg><I
126a4e54154Smrg>name</I
127a4e54154Smrg></TT
128a4e54154Smrg>);</CODE
129a4e54154Smrg></P
130a4e54154Smrg><P
131a4e54154Smrg></P
132a4e54154Smrg></DIV
133a4e54154Smrg></DIV
134a4e54154Smrg><DIV
135a4e54154SmrgCLASS="REFSECT1"
136a4e54154Smrg><A
137a4e54154SmrgNAME="AEN3689"
138a4e54154Smrg></A
139a4e54154Smrg><H2
140a4e54154Smrg>Description</H2
141a4e54154Smrg><P
142a4e54154Smrg>Given the specified external entity name, return the associated filename.
143a4e54154SmrgThis provides applications a way to convert various configuration file
144a4e54154Smrgreferences into filename form.
145a4e54154Smrg    </P
146a4e54154Smrg><P
147a4e54154Smrg>A null or empty <TT
148a4e54154SmrgCLASS="PARAMETER"
149a4e54154Smrg><I
150a4e54154Smrg>name</I
151a4e54154Smrg></TT
152a4e54154Smrg> indicates that the default configuration file should
153a4e54154Smrgbe used; which file this references can be overridden with the
154a4e54154SmrgFONTCONFIG_FILE environment variable.  Next, if the name starts with <TT
155a4e54154SmrgCLASS="PARAMETER"
156a4e54154Smrg><I
157a4e54154Smrg>~</I
158a4e54154Smrg></TT
159a4e54154Smrg>, it
160a4e54154Smrgrefers to a file in the current users home directory.  Otherwise if the name
161a4e54154Smrgdoesn't start with '/', it refers to a file in the default configuration
162a4e54154Smrgdirectory; the built-in default directory can be overridden with the
163a4e54154SmrgFONTCONFIG_PATH environment variable.
164a4e54154Smrg    </P
165a4e54154Smrg><P
166a4e54154Smrg>The result of this function is affected by the FONTCONFIG_SYSROOT environment variable or equivalent functionality.
1671cc69409Smrg            </P
168a4e54154Smrg></DIV
169a4e54154Smrg><DIV
170a4e54154SmrgCLASS="NAVFOOTER"
171a4e54154Smrg><HR
172a4e54154SmrgALIGN="LEFT"
173a4e54154SmrgWIDTH="100%"><TABLE
174a4e54154SmrgSUMMARY="Footer navigation table"
175a4e54154SmrgWIDTH="100%"
176a4e54154SmrgBORDER="0"
177a4e54154SmrgCELLPADDING="0"
178a4e54154SmrgCELLSPACING="0"
179a4e54154Smrg><TR
180a4e54154Smrg><TD
181a4e54154SmrgWIDTH="33%"
182a4e54154SmrgALIGN="left"
183a4e54154SmrgVALIGN="top"
184a4e54154Smrg><A
185a4e54154SmrgHREF="fcconfigfilename.html"
186a4e54154SmrgACCESSKEY="P"
187a4e54154Smrg>&#60;&#60;&#60; Previous</A
188a4e54154Smrg></TD
189a4e54154Smrg><TD
190a4e54154SmrgWIDTH="34%"
191a4e54154SmrgALIGN="center"
192a4e54154SmrgVALIGN="top"
193a4e54154Smrg><A
194a4e54154SmrgHREF="t1.html"
195a4e54154SmrgACCESSKEY="H"
196a4e54154Smrg>Home</A
197a4e54154Smrg></TD
198a4e54154Smrg><TD
199a4e54154SmrgWIDTH="33%"
200a4e54154SmrgALIGN="right"
201a4e54154SmrgVALIGN="top"
202a4e54154Smrg><A
203a4e54154SmrgHREF="fcconfigparseandload.html"
204a4e54154SmrgACCESSKEY="N"
205a4e54154Smrg>Next &#62;&#62;&#62;</A
206a4e54154Smrg></TD
207a4e54154Smrg></TR
208a4e54154Smrg><TR
209a4e54154Smrg><TD
210a4e54154SmrgWIDTH="33%"
211a4e54154SmrgALIGN="left"
212a4e54154SmrgVALIGN="top"
213a4e54154Smrg>FcConfigFilename</TD
214a4e54154Smrg><TD
215a4e54154SmrgWIDTH="34%"
216a4e54154SmrgALIGN="center"
217a4e54154SmrgVALIGN="top"
218a4e54154Smrg><A
219a4e54154SmrgHREF="x103.html#AEN3038"
220a4e54154SmrgACCESSKEY="U"
221a4e54154Smrg>Up</A
222a4e54154Smrg></TD
223a4e54154Smrg><TD
224a4e54154SmrgWIDTH="33%"
225a4e54154SmrgALIGN="right"
226a4e54154SmrgVALIGN="top"
227a4e54154Smrg>FcConfigParseAndLoad</TD
228a4e54154Smrg></TR
229a4e54154Smrg></TABLE
230a4e54154Smrg></DIV
231a4e54154Smrg></BODY
232a4e54154Smrg></HTML
233a4e54154Smrg>