fcstrcopyfilename.html revision c9710b42
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#AEN4547"><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><<< 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 >>></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="AEN4820" 79></A 80><H2 81>Name</H2 82>FcStrCopyFilename -- create a complete path from a filename</DIV 83><DIV 84CLASS="REFSYNOPSISDIV" 85><A 86NAME="AEN4823" 87></A 88><H2 89>Synopsis</H2 90><DIV 91CLASS="FUNCSYNOPSIS" 92><P 93></P 94><A 95NAME="AEN4824" 96></A 97><TABLE 98BORDER="0" 99BGCOLOR="#E0E0E0" 100WIDTH="100%" 101><TR 102><TD 103><PRE 104CLASS="FUNCSYNOPSISINFO" 105>#include <fontconfig/fontconfig.h> 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="AEN4831" 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="AEN4837" 162></A 163><H2 164>Version</H2 165><P 166>Fontconfig version 2.10.93 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><<< 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 >>></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#AEN4547" 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>