fcstrcopyfilename.html revision 6fc018e4 
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="x102.html#AEN4593"><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="AEN4866"
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="AEN4869"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN4870"
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="AEN4877"
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="REFSECT1"
160><A
161NAME="AEN4883"
162></A
163><H2
164>Version</H2
165><P
166>Fontconfig version 2.11.0
167
168	    </P
169></DIV
170><DIV
171CLASS="NAVFOOTER"
172><HR
173ALIGN="LEFT"
174WIDTH="100%"><TABLE
175SUMMARY="Footer navigation table"
176WIDTH="100%"
177BORDER="0"
178CELLPADDING="0"
179CELLSPACING="0"
180><TR
181><TD
182WIDTH="33%"
183ALIGN="left"
184VALIGN="top"
185><A
186HREF="fcstrdowncase.html"
187ACCESSKEY="P"
188>&#60;&#60;&#60; Previous</A
189></TD
190><TD
191WIDTH="34%"
192ALIGN="center"
193VALIGN="top"
194><A
195HREF="t1.html"
196ACCESSKEY="H"
197>Home</A
198></TD
199><TD
200WIDTH="33%"
201ALIGN="right"
202VALIGN="top"
203><A
204HREF="fcstrcmp.html"
205ACCESSKEY="N"
206>Next &#62;&#62;&#62;</A
207></TD
208></TR
209><TR
210><TD
211WIDTH="33%"
212ALIGN="left"
213VALIGN="top"
214>FcStrDowncase</TD
215><TD
216WIDTH="34%"
217ALIGN="center"
218VALIGN="top"
219><A
220HREF="x102.html#AEN4593"
221ACCESSKEY="U"
222>Up</A
223></TD
224><TD
225WIDTH="33%"
226ALIGN="right"
227VALIGN="top"
228>FcStrCmp</TD
229></TR
230></TABLE
231></DIV
232></BODY
233></HTML
234>