fcstrcopyfilename.html revision a6844aab
1a6844aabSmrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2a6844aabSmrg<HTML 3a6844aabSmrg><HEAD 4a6844aabSmrg><TITLE 5a6844aabSmrg>FcStrCopyFilename</TITLE 6a6844aabSmrg><META 7a6844aabSmrgNAME="GENERATOR" 8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9a6844aabSmrgREL="HOME" 10a6844aabSmrgHREF="t1.html"><LINK 11a6844aabSmrgREL="UP" 12a6844aabSmrgTITLE="String utilities" 13a6844aabSmrgHREF="x102.html#AEN4336"><LINK 14a6844aabSmrgREL="PREVIOUS" 15a6844aabSmrgTITLE="FcStrDowncase" 16a6844aabSmrgHREF="fcstrdowncase.html"><LINK 17a6844aabSmrgREL="NEXT" 18a6844aabSmrgTITLE="FcStrCmp" 19a6844aabSmrgHREF="fcstrcmp.html"></HEAD 20a6844aabSmrg><BODY 21a6844aabSmrgCLASS="REFENTRY" 22a6844aabSmrgBGCOLOR="#FFFFFF" 23a6844aabSmrgTEXT="#000000" 24a6844aabSmrgLINK="#0000FF" 25a6844aabSmrgVLINK="#840084" 26a6844aabSmrgALINK="#0000FF" 27a6844aabSmrg><DIV 28a6844aabSmrgCLASS="NAVHEADER" 29a6844aabSmrg><TABLE 30a6844aabSmrgSUMMARY="Header navigation table" 31a6844aabSmrgWIDTH="100%" 32a6844aabSmrgBORDER="0" 33a6844aabSmrgCELLPADDING="0" 34a6844aabSmrgCELLSPACING="0" 35a6844aabSmrg><TR 36a6844aabSmrg><TH 37a6844aabSmrgCOLSPAN="3" 38a6844aabSmrgALIGN="center" 39a6844aabSmrg></TH 40a6844aabSmrg></TR 41a6844aabSmrg><TR 42a6844aabSmrg><TD 43a6844aabSmrgWIDTH="10%" 44a6844aabSmrgALIGN="left" 45a6844aabSmrgVALIGN="bottom" 46a6844aabSmrg><A 47a6844aabSmrgHREF="fcstrdowncase.html" 48a6844aabSmrgACCESSKEY="P" 49a6844aabSmrg><<< Previous</A 50a6844aabSmrg></TD 51a6844aabSmrg><TD 52a6844aabSmrgWIDTH="80%" 53a6844aabSmrgALIGN="center" 54a6844aabSmrgVALIGN="bottom" 55a6844aabSmrg></TD 56a6844aabSmrg><TD 57a6844aabSmrgWIDTH="10%" 58a6844aabSmrgALIGN="right" 59a6844aabSmrgVALIGN="bottom" 60a6844aabSmrg><A 61a6844aabSmrgHREF="fcstrcmp.html" 62a6844aabSmrgACCESSKEY="N" 63a6844aabSmrg>Next >>></A 64a6844aabSmrg></TD 65a6844aabSmrg></TR 66a6844aabSmrg></TABLE 67a6844aabSmrg><HR 68a6844aabSmrgALIGN="LEFT" 69a6844aabSmrgWIDTH="100%"></DIV 70a6844aabSmrg><H1 71a6844aabSmrg><A 72a6844aabSmrgNAME="FCSTRCOPYFILENAME" 73a6844aabSmrg></A 74a6844aabSmrg>FcStrCopyFilename</H1 75a6844aabSmrg><DIV 76a6844aabSmrgCLASS="REFNAMEDIV" 77a6844aabSmrg><A 78a6844aabSmrgNAME="AEN4609" 79a6844aabSmrg></A 80a6844aabSmrg><H2 81a6844aabSmrg>Name</H2 82a6844aabSmrg>FcStrCopyFilename -- create a complete path from a filename</DIV 83a6844aabSmrg><DIV 84a6844aabSmrgCLASS="REFSYNOPSISDIV" 85a6844aabSmrg><A 86a6844aabSmrgNAME="AEN4612" 87a6844aabSmrg></A 88a6844aabSmrg><H2 89a6844aabSmrg>Synopsis</H2 90a6844aabSmrg><DIV 91a6844aabSmrgCLASS="FUNCSYNOPSIS" 92a6844aabSmrg><P 93a6844aabSmrg></P 94a6844aabSmrg><A 95a6844aabSmrgNAME="AEN4613" 96a6844aabSmrg></A 97a6844aabSmrg><TABLE 98a6844aabSmrgBORDER="0" 99a6844aabSmrgBGCOLOR="#E0E0E0" 100a6844aabSmrgWIDTH="100%" 101a6844aabSmrg><TR 102a6844aabSmrg><TD 103a6844aabSmrg><PRE 104a6844aabSmrgCLASS="FUNCSYNOPSISINFO" 105a6844aabSmrg>#include <fontconfig.h> 106a6844aabSmrg </PRE 107a6844aabSmrg></TD 108a6844aabSmrg></TR 109a6844aabSmrg></TABLE 110a6844aabSmrg><P 111a6844aabSmrg><CODE 112a6844aabSmrg><CODE 113a6844aabSmrgCLASS="FUNCDEF" 114a6844aabSmrg>FcChar8 * <TT 115a6844aabSmrgCLASS="FUNCTION" 116a6844aabSmrg>FcStrCopyFilename</TT 117a6844aabSmrg></CODE 118a6844aabSmrg>(const FcChar8 *<TT 119a6844aabSmrgCLASS="PARAMETER" 120a6844aabSmrg><I 121a6844aabSmrg>s</I 122a6844aabSmrg></TT 123a6844aabSmrg>);</CODE 124a6844aabSmrg></P 125a6844aabSmrg><P 126a6844aabSmrg></P 127a6844aabSmrg></DIV 128a6844aabSmrg></DIV 129a6844aabSmrg><DIV 130a6844aabSmrgCLASS="REFSECT1" 131a6844aabSmrg><A 132a6844aabSmrgNAME="AEN4620" 133a6844aabSmrg></A 134a6844aabSmrg><H2 135a6844aabSmrg>Description</H2 136a6844aabSmrg><P 137a6844aabSmrg><TT 138a6844aabSmrgCLASS="FUNCTION" 139a6844aabSmrg>FcStrCopyFilename</TT 140a6844aabSmrg> constructs an absolute pathname from 141a6844aabSmrg<TT 142a6844aabSmrgCLASS="PARAMETER" 143a6844aabSmrg><I 144a6844aabSmrg>s</I 145a6844aabSmrg></TT 146a6844aabSmrg>. It converts any leading '~' characters in 147a6844aabSmrgto the value of the HOME environment variable, and any relative paths are 148a6844aabSmrgconverted to absolute paths using the current working directory. Sequences 149a6844aabSmrgof '/' characters are converted to a single '/', and names containing the 150a6844aabSmrgcurrent directory '.' or parent directory '..' are correctly reconstructed. 151a6844aabSmrgReturns NULL if '~' is the leading character and HOME is unset or disabled 152a6844aabSmrg(see <TT 153a6844aabSmrgCLASS="FUNCTION" 154a6844aabSmrg>FcConfigEnableHome</TT 155a6844aabSmrg>). 156a6844aabSmrg </P 157a6844aabSmrg></DIV 158a6844aabSmrg><DIV 159a6844aabSmrgCLASS="REFSECT1" 160a6844aabSmrg><A 161a6844aabSmrgNAME="AEN4626" 162a6844aabSmrg></A 163a6844aabSmrg><H2 164a6844aabSmrg>Version</H2 165a6844aabSmrg><P 166a6844aabSmrg>Fontconfig version 2.8.0 167a6844aabSmrg 168a6844aabSmrg </P 169a6844aabSmrg></DIV 170a6844aabSmrg><DIV 171a6844aabSmrgCLASS="NAVFOOTER" 172a6844aabSmrg><HR 173a6844aabSmrgALIGN="LEFT" 174a6844aabSmrgWIDTH="100%"><TABLE 175a6844aabSmrgSUMMARY="Footer navigation table" 176a6844aabSmrgWIDTH="100%" 177a6844aabSmrgBORDER="0" 178a6844aabSmrgCELLPADDING="0" 179a6844aabSmrgCELLSPACING="0" 180a6844aabSmrg><TR 181a6844aabSmrg><TD 182a6844aabSmrgWIDTH="33%" 183a6844aabSmrgALIGN="left" 184a6844aabSmrgVALIGN="top" 185a6844aabSmrg><A 186a6844aabSmrgHREF="fcstrdowncase.html" 187a6844aabSmrgACCESSKEY="P" 188a6844aabSmrg><<< Previous</A 189a6844aabSmrg></TD 190a6844aabSmrg><TD 191a6844aabSmrgWIDTH="34%" 192a6844aabSmrgALIGN="center" 193a6844aabSmrgVALIGN="top" 194a6844aabSmrg><A 195a6844aabSmrgHREF="t1.html" 196a6844aabSmrgACCESSKEY="H" 197a6844aabSmrg>Home</A 198a6844aabSmrg></TD 199a6844aabSmrg><TD 200a6844aabSmrgWIDTH="33%" 201a6844aabSmrgALIGN="right" 202a6844aabSmrgVALIGN="top" 203a6844aabSmrg><A 204a6844aabSmrgHREF="fcstrcmp.html" 205a6844aabSmrgACCESSKEY="N" 206a6844aabSmrg>Next >>></A 207a6844aabSmrg></TD 208a6844aabSmrg></TR 209a6844aabSmrg><TR 210a6844aabSmrg><TD 211a6844aabSmrgWIDTH="33%" 212a6844aabSmrgALIGN="left" 213a6844aabSmrgVALIGN="top" 214a6844aabSmrg>FcStrDowncase</TD 215a6844aabSmrg><TD 216a6844aabSmrgWIDTH="34%" 217a6844aabSmrgALIGN="center" 218a6844aabSmrgVALIGN="top" 219a6844aabSmrg><A 220a6844aabSmrgHREF="x102.html#AEN4336" 221a6844aabSmrgACCESSKEY="U" 222a6844aabSmrg>Up</A 223a6844aabSmrg></TD 224a6844aabSmrg><TD 225a6844aabSmrgWIDTH="33%" 226a6844aabSmrgALIGN="right" 227a6844aabSmrgVALIGN="top" 228a6844aabSmrg>FcStrCmp</TD 229a6844aabSmrg></TR 230a6844aabSmrg></TABLE 231a6844aabSmrg></DIV 232a6844aabSmrg></BODY 233a6844aabSmrg></HTML 234a6844aabSmrg>