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>FcStrCopyFilename</TITLE
6><META
7NAME="GENERATOR"
8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9REL="HOME"
10HREF="t1.html"><LINK
11REL="UP"
12TITLE="String utilities"
13HREF="x103.html#AEN5141"><LINK
14REL="PREVIOUS"
15TITLE="FcStrDowncase"
16HREF="fcstrdowncase.html"><LINK
17REL="NEXT"
18TITLE="FcStrCmp"
19HREF="fcstrcmp.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="fcstrdowncase.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="fcstrcmp.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="FCSTRCOPYFILENAME"
73></A
74>FcStrCopyFilename</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN5395"
79></A
80><H2
81>Name</H2
82>FcStrCopyFilename&nbsp;--&nbsp;create a complete path from a filename</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN5398"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN5399"
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>FcStrCopyFilename</TT
117></CODE
118>(const FcChar8 *<TT
119CLASS="PARAMETER"
120><I
121>s</I
122></TT
123>);</CODE
124></P
125><P
126></P
127></DIV
128></DIV
129><DIV
130CLASS="REFSECT1"
131><A
132NAME="AEN5406"
133></A
134><H2
135>Description</H2
136><P
137><TT
138CLASS="FUNCTION"
139>FcStrCopyFilename</TT
140> constructs an absolute pathname from
141<TT
142CLASS="PARAMETER"
143><I
144>s</I
145></TT
146>. It converts any leading '~' characters in
147to the value of the HOME environment variable, and any relative paths are
148converted to absolute paths using the current working directory. Sequences
149of '/' characters are converted to a single '/', and names containing the
150current directory '.' or parent directory '..' are correctly reconstructed.
151Returns NULL if '~' is the leading character and HOME is unset or disabled
152(see <TT
153CLASS="FUNCTION"
154>FcConfigEnableHome</TT
155>).
156            </P
157></DIV
158><DIV
159CLASS="NAVFOOTER"
160><HR
161ALIGN="LEFT"
162WIDTH="100%"><TABLE
163SUMMARY="Footer navigation table"
164WIDTH="100%"
165BORDER="0"
166CELLPADDING="0"
167CELLSPACING="0"
168><TR
169><TD
170WIDTH="33%"
171ALIGN="left"
172VALIGN="top"
173><A
174HREF="fcstrdowncase.html"
175ACCESSKEY="P"
176>&#60;&#60;&#60; Previous</A
177></TD
178><TD
179WIDTH="34%"
180ALIGN="center"
181VALIGN="top"
182><A
183HREF="t1.html"
184ACCESSKEY="H"
185>Home</A
186></TD
187><TD
188WIDTH="33%"
189ALIGN="right"
190VALIGN="top"
191><A
192HREF="fcstrcmp.html"
193ACCESSKEY="N"
194>Next &#62;&#62;&#62;</A
195></TD
196></TR
197><TR
198><TD
199WIDTH="33%"
200ALIGN="left"
201VALIGN="top"
202>FcStrDowncase</TD
203><TD
204WIDTH="34%"
205ALIGN="center"
206VALIGN="top"
207><A
208HREF="x103.html#AEN5141"
209ACCESSKEY="U"
210>Up</A
211></TD
212><TD
213WIDTH="33%"
214ALIGN="right"
215VALIGN="top"
216>FcStrCmp</TD
217></TR
218></TABLE
219></DIV
220></BODY
221></HTML
222>