fcconfigfilename.html revision a32e9e42 
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>FcConfigFilename</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="x103.html#AEN3038"><LINK
14REL="PREVIOUS"
15TITLE="FcFontList"
16HREF="fcfontlist.html"><LINK
17REL="NEXT"
18TITLE="FcConfigParseAndLoad"
19HREF="fcconfigparseandload.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="fcfontlist.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="fcconfigparseandload.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="FCCONFIGFILENAME"
73></A
74>FcConfigFilename</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN3653"
79></A
80><H2
81>Name</H2
82>FcConfigFilename&nbsp;--&nbsp;Find a config file</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN3656"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN3657"
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>FcChar8 * <TT
115CLASS="FUNCTION"
116>FcConfigFilename</TT
117></CODE
118>(const FcChar8 *<TT
119CLASS="PARAMETER"
120><I
121>name</I
122></TT
123>);</CODE
124></P
125><P
126></P
127></DIV
128></DIV
129><DIV
130CLASS="REFSECT1"
131><A
132NAME="AEN3664"
133></A
134><H2
135>Description</H2
136><P
137>Given the specified external entity name, return the associated filename.
138This provides applications a way to convert various configuration file
139references into filename form.
140    </P
141><P
142>A null or empty <TT
143CLASS="PARAMETER"
144><I
145>name</I
146></TT
147> indicates that the default configuration file should
148be used; which file this references can be overridden with the
149FONTCONFIG_FILE environment variable.  Next, if the name starts with <TT
150CLASS="PARAMETER"
151><I
152>~</I
153></TT
154>, it
155refers to a file in the current users home directory.  Otherwise if the name
156doesn't start with '/', it refers to a file in the default configuration
157directory; the built-in default directory can be overridden with the
158FONTCONFIG_PATH environment variable.
159	    </P
160></DIV
161><DIV
162CLASS="NAVFOOTER"
163><HR
164ALIGN="LEFT"
165WIDTH="100%"><TABLE
166SUMMARY="Footer navigation table"
167WIDTH="100%"
168BORDER="0"
169CELLPADDING="0"
170CELLSPACING="0"
171><TR
172><TD
173WIDTH="33%"
174ALIGN="left"
175VALIGN="top"
176><A
177HREF="fcfontlist.html"
178ACCESSKEY="P"
179>&#60;&#60;&#60; Previous</A
180></TD
181><TD
182WIDTH="34%"
183ALIGN="center"
184VALIGN="top"
185><A
186HREF="t1.html"
187ACCESSKEY="H"
188>Home</A
189></TD
190><TD
191WIDTH="33%"
192ALIGN="right"
193VALIGN="top"
194><A
195HREF="fcconfigparseandload.html"
196ACCESSKEY="N"
197>Next &#62;&#62;&#62;</A
198></TD
199></TR
200><TR
201><TD
202WIDTH="33%"
203ALIGN="left"
204VALIGN="top"
205>FcFontList</TD
206><TD
207WIDTH="34%"
208ALIGN="center"
209VALIGN="top"
210><A
211HREF="x103.html#AEN3038"
212ACCESSKEY="U"
213>Up</A
214></TD
215><TD
216WIDTH="33%"
217ALIGN="right"
218VALIGN="top"
219>FcConfigParseAndLoad</TD
220></TR
221></TABLE
222></DIV
223></BODY
224></HTML
225>