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 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 HREF="t1.html"><LINK 11 REL="UP" 12 TITLE="String utilities" 13 HREF="x103.html#AEN5141"><LINK 14 REL="PREVIOUS" 15 TITLE="FcStrDowncase" 16 HREF="fcstrdowncase.html"><LINK 17 REL="NEXT" 18 TITLE="FcStrCmp" 19 HREF="fcstrcmp.html"></HEAD 20 ><BODY 21 CLASS="REFENTRY" 22 BGCOLOR="#FFFFFF" 23 TEXT="#000000" 24 LINK="#0000FF" 25 VLINK="#840084" 26 ALINK="#0000FF" 27 ><DIV 28 CLASS="NAVHEADER" 29 ><TABLE 30 SUMMARY="Header navigation table" 31 WIDTH="100%" 32 BORDER="0" 33 CELLPADDING="0" 34 CELLSPACING="0" 35 ><TR 36 ><TH 37 COLSPAN="3" 38 ALIGN="center" 39 ></TH 40 ></TR 41 ><TR 42 ><TD 43 WIDTH="10%" 44 ALIGN="left" 45 VALIGN="bottom" 46 ><A 47 HREF="fcstrdowncase.html" 48 ACCESSKEY="P" 49 ><<< Previous</A 50 ></TD 51 ><TD 52 WIDTH="80%" 53 ALIGN="center" 54 VALIGN="bottom" 55 ></TD 56 ><TD 57 WIDTH="10%" 58 ALIGN="right" 59 VALIGN="bottom" 60 ><A 61 HREF="fcstrcmp.html" 62 ACCESSKEY="N" 63 >Next >>></A 64 ></TD 65 ></TR 66 ></TABLE 67 ><HR 68 ALIGN="LEFT" 69 WIDTH="100%"></DIV 70 ><H1 71 ><A 72 NAME="FCSTRCOPYFILENAME" 73 ></A 74 >FcStrCopyFilename</H1 75 ><DIV 76 CLASS="REFNAMEDIV" 77 ><A 78 NAME="AEN5395" 79 ></A 80 ><H2 81 >Name</H2 82 >FcStrCopyFilename -- create a complete path from a filename</DIV 83 ><DIV 84 CLASS="REFSYNOPSISDIV" 85 ><A 86 NAME="AEN5398" 87 ></A 88 ><H2 89 >Synopsis</H2 90 ><DIV 91 CLASS="FUNCSYNOPSIS" 92 ><P 93 ></P 94 ><A 95 NAME="AEN5399" 96 ></A 97 ><TABLE 98 BORDER="0" 99 BGCOLOR="#E0E0E0" 100 WIDTH="100%" 101 ><TR 102 ><TD 103 ><PRE 104 CLASS="FUNCSYNOPSISINFO" 105 >#include <fontconfig/fontconfig.h> 106 </PRE 107 ></TD 108 ></TR 109 ></TABLE 110 ><P 111 ><CODE 112 ><CODE 113 CLASS="FUNCDEF" 114 >FcChar8 * <TT 115 CLASS="FUNCTION" 116 >FcStrCopyFilename</TT 117 ></CODE 118 >(const FcChar8 *<TT 119 CLASS="PARAMETER" 120 ><I 121 >s</I 122 ></TT 123 >);</CODE 124 ></P 125 ><P 126 ></P 127 ></DIV 128 ></DIV 129 ><DIV 130 CLASS="REFSECT1" 131 ><A 132 NAME="AEN5406" 133 ></A 134 ><H2 135 >Description</H2 136 ><P 137 ><TT 138 CLASS="FUNCTION" 139 >FcStrCopyFilename</TT 140 > constructs an absolute pathname from 141 <TT 142 CLASS="PARAMETER" 143 ><I 144 >s</I 145 ></TT 146 >. It converts any leading '~' characters in 147 to the value of the HOME environment variable, and any relative paths are 148 converted to absolute paths using the current working directory. Sequences 149 of '/' characters are converted to a single '/', and names containing the 150 current directory '.' or parent directory '..' are correctly reconstructed. 151 Returns NULL if '~' is the leading character and HOME is unset or disabled 152 (see <TT 153 CLASS="FUNCTION" 154 >FcConfigEnableHome</TT 155 >). 156 </P 157 ></DIV 158 ><DIV 159 CLASS="NAVFOOTER" 160 ><HR 161 ALIGN="LEFT" 162 WIDTH="100%"><TABLE 163 SUMMARY="Footer navigation table" 164 WIDTH="100%" 165 BORDER="0" 166 CELLPADDING="0" 167 CELLSPACING="0" 168 ><TR 169 ><TD 170 WIDTH="33%" 171 ALIGN="left" 172 VALIGN="top" 173 ><A 174 HREF="fcstrdowncase.html" 175 ACCESSKEY="P" 176 ><<< Previous</A 177 ></TD 178 ><TD 179 WIDTH="34%" 180 ALIGN="center" 181 VALIGN="top" 182 ><A 183 HREF="t1.html" 184 ACCESSKEY="H" 185 >Home</A 186 ></TD 187 ><TD 188 WIDTH="33%" 189 ALIGN="right" 190 VALIGN="top" 191 ><A 192 HREF="fcstrcmp.html" 193 ACCESSKEY="N" 194 >Next >>></A 195 ></TD 196 ></TR 197 ><TR 198 ><TD 199 WIDTH="33%" 200 ALIGN="left" 201 VALIGN="top" 202 >FcStrDowncase</TD 203 ><TD 204 WIDTH="34%" 205 ALIGN="center" 206 VALIGN="top" 207 ><A 208 HREF="x103.html#AEN5141" 209 ACCESSKEY="U" 210 >Up</A 211 ></TD 212 ><TD 213 WIDTH="33%" 214 ALIGN="right" 215 VALIGN="top" 216 >FcStrCmp</TD 217 ></TR 218 ></TABLE 219 ></DIV 220 ></BODY 221 ></HTML 222 >