fcconfigfilename.html revision a6844aab
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>FcConfigFilename</TITLE
6a6844aabSmrg><META
7a6844aabSmrgNAME="GENERATOR"
8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a6844aabSmrgREL="HOME"
10a6844aabSmrgHREF="t1.html"><LINK
11a6844aabSmrgREL="UP"
12a6844aabSmrgTITLE="FcConfig"
13a6844aabSmrgHREF="x102.html#AEN2554"><LINK
14a6844aabSmrgREL="PREVIOUS"
15a6844aabSmrgTITLE="FcFontList"
16a6844aabSmrgHREF="fcfontlist.html"><LINK
17a6844aabSmrgREL="NEXT"
18a6844aabSmrgTITLE="FcConfigParseAndLoad"
19a6844aabSmrgHREF="fcconfigparseandload.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="fcfontlist.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="fcconfigparseandload.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="FCCONFIGFILENAME"
73a6844aabSmrg></A
74a6844aabSmrg>FcConfigFilename</H1
75a6844aabSmrg><DIV
76a6844aabSmrgCLASS="REFNAMEDIV"
77a6844aabSmrg><A
78a6844aabSmrgNAME="AEN3222"
79a6844aabSmrg></A
80a6844aabSmrg><H2
81a6844aabSmrg>Name</H2
82a6844aabSmrg>FcConfigFilename&nbsp;--&nbsp;Find a config file</DIV
83a6844aabSmrg><DIV
84a6844aabSmrgCLASS="REFSYNOPSISDIV"
85a6844aabSmrg><A
86a6844aabSmrgNAME="AEN3225"
87a6844aabSmrg></A
88a6844aabSmrg><H2
89a6844aabSmrg>Synopsis</H2
90a6844aabSmrg><DIV
91a6844aabSmrgCLASS="FUNCSYNOPSIS"
92a6844aabSmrg><P
93a6844aabSmrg></P
94a6844aabSmrg><A
95a6844aabSmrgNAME="AEN3226"
96a6844aabSmrg></A
97a6844aabSmrg><TABLE
98a6844aabSmrgBORDER="0"
99a6844aabSmrgBGCOLOR="#E0E0E0"
100a6844aabSmrgWIDTH="100%"
101a6844aabSmrg><TR
102a6844aabSmrg><TD
103a6844aabSmrg><PRE
104a6844aabSmrgCLASS="FUNCSYNOPSISINFO"
105a6844aabSmrg>#include &#60;fontconfig.h&#62;
106a6844aabSmrg	</PRE
107a6844aabSmrg></TD
108a6844aabSmrg></TR
109a6844aabSmrg></TABLE
110a6844aabSmrg><P
111a6844aabSmrg><CODE
112a6844aabSmrg><CODE
113a6844aabSmrgCLASS="FUNCDEF"
114a6844aabSmrg>FcChar8 * <TT
115a6844aabSmrgCLASS="FUNCTION"
116a6844aabSmrg>FcConfigFilename</TT
117a6844aabSmrg></CODE
118a6844aabSmrg>(const FcChar8 *<TT
119a6844aabSmrgCLASS="PARAMETER"
120a6844aabSmrg><I
121a6844aabSmrg>name</I
122a6844aabSmrg></TT
123a6844aabSmrg>);</CODE
124a6844aabSmrg></P
125a6844aabSmrg><P
126a6844aabSmrg></P
127a6844aabSmrg></DIV
128a6844aabSmrg></DIV
129a6844aabSmrg><DIV
130a6844aabSmrgCLASS="REFSECT1"
131a6844aabSmrg><A
132a6844aabSmrgNAME="AEN3233"
133a6844aabSmrg></A
134a6844aabSmrg><H2
135a6844aabSmrg>Description</H2
136a6844aabSmrg><P
137a6844aabSmrg>Given the specified external entity name, return the associated filename.
138a6844aabSmrgThis provides applications a way to convert various configuration file
139a6844aabSmrgreferences into filename form.
140a6844aabSmrg    </P
141a6844aabSmrg><P
142a6844aabSmrg>A null or empty <TT
143a6844aabSmrgCLASS="PARAMETER"
144a6844aabSmrg><I
145a6844aabSmrg>name</I
146a6844aabSmrg></TT
147a6844aabSmrg> indicates that the default configuration file should
148a6844aabSmrgbe used; which file this references can be overridden with the
149a6844aabSmrgFC_CONFIG_FILE environment variable.  Next, if the name starts with <TT
150a6844aabSmrgCLASS="PARAMETER"
151a6844aabSmrg><I
152a6844aabSmrg>~</I
153a6844aabSmrg></TT
154a6844aabSmrg>, it
155a6844aabSmrgrefers to a file in the current users home directory.  Otherwise if the name
156a6844aabSmrgdoesn't start with '/', it refers to a file in the default configuration
157a6844aabSmrgdirectory; the built-in default directory can be overridden with the
158a6844aabSmrgFC_CONFIG_DIR environment variable.
159a6844aabSmrg	    </P
160a6844aabSmrg></DIV
161a6844aabSmrg><DIV
162a6844aabSmrgCLASS="REFSECT1"
163a6844aabSmrg><A
164a6844aabSmrgNAME="AEN3239"
165a6844aabSmrg></A
166a6844aabSmrg><H2
167a6844aabSmrg>Version</H2
168a6844aabSmrg><P
169a6844aabSmrg>Fontconfig version 2.8.0
170a6844aabSmrg
171a6844aabSmrg	    </P
172a6844aabSmrg></DIV
173a6844aabSmrg><DIV
174a6844aabSmrgCLASS="NAVFOOTER"
175a6844aabSmrg><HR
176a6844aabSmrgALIGN="LEFT"
177a6844aabSmrgWIDTH="100%"><TABLE
178a6844aabSmrgSUMMARY="Footer navigation table"
179a6844aabSmrgWIDTH="100%"
180a6844aabSmrgBORDER="0"
181a6844aabSmrgCELLPADDING="0"
182a6844aabSmrgCELLSPACING="0"
183a6844aabSmrg><TR
184a6844aabSmrg><TD
185a6844aabSmrgWIDTH="33%"
186a6844aabSmrgALIGN="left"
187a6844aabSmrgVALIGN="top"
188a6844aabSmrg><A
189a6844aabSmrgHREF="fcfontlist.html"
190a6844aabSmrgACCESSKEY="P"
191a6844aabSmrg>&#60;&#60;&#60; Previous</A
192a6844aabSmrg></TD
193a6844aabSmrg><TD
194a6844aabSmrgWIDTH="34%"
195a6844aabSmrgALIGN="center"
196a6844aabSmrgVALIGN="top"
197a6844aabSmrg><A
198a6844aabSmrgHREF="t1.html"
199a6844aabSmrgACCESSKEY="H"
200a6844aabSmrg>Home</A
201a6844aabSmrg></TD
202a6844aabSmrg><TD
203a6844aabSmrgWIDTH="33%"
204a6844aabSmrgALIGN="right"
205a6844aabSmrgVALIGN="top"
206a6844aabSmrg><A
207a6844aabSmrgHREF="fcconfigparseandload.html"
208a6844aabSmrgACCESSKEY="N"
209a6844aabSmrg>Next &#62;&#62;&#62;</A
210a6844aabSmrg></TD
211a6844aabSmrg></TR
212a6844aabSmrg><TR
213a6844aabSmrg><TD
214a6844aabSmrgWIDTH="33%"
215a6844aabSmrgALIGN="left"
216a6844aabSmrgVALIGN="top"
217a6844aabSmrg>FcFontList</TD
218a6844aabSmrg><TD
219a6844aabSmrgWIDTH="34%"
220a6844aabSmrgALIGN="center"
221a6844aabSmrgVALIGN="top"
222a6844aabSmrg><A
223a6844aabSmrgHREF="x102.html#AEN2554"
224a6844aabSmrgACCESSKEY="U"
225a6844aabSmrg>Up</A
226a6844aabSmrg></TD
227a6844aabSmrg><TD
228a6844aabSmrgWIDTH="33%"
229a6844aabSmrgALIGN="right"
230a6844aabSmrgVALIGN="top"
231a6844aabSmrg>FcConfigParseAndLoad</TD
232a6844aabSmrg></TR
233a6844aabSmrg></TABLE
234a6844aabSmrg></DIV
235a6844aabSmrg></BODY
236a6844aabSmrg></HTML
237a6844aabSmrg>