doc/fontconfig-devel/fcstrcopyfilename.html

   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#AEN4792"><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 >&#60;&#60;&#60; 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 &#62;&#62;&#62;</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="AEN5046"
  79 ></A
  80 ><H2
  81 >Name</H2
  82 >FcStrCopyFilename&nbsp;--&nbsp;create a complete path from a filename</DIV
  83 ><DIV
  84 CLASS="REFSYNOPSISDIV"
  85 ><A
  86 NAME="AEN5049"
  87 ></A
  88 ><H2
  89 >Synopsis</H2
  90 ><DIV
  91 CLASS="FUNCSYNOPSIS"
  92 ><P
  93 ></P
  94 ><A
  95 NAME="AEN5050"
  96 ></A
  97 ><TABLE
  98 BORDER="0"
  99 BGCOLOR="#E0E0E0"
 100 WIDTH="100%"
 101 ><TR
 102 ><TD
 103 ><PRE
 104 CLASS="FUNCSYNOPSISINFO"
 105 >#include &#60;fontconfig/fontconfig.h&#62;
 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="AEN5057"
 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 >&#60;&#60;&#60; 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 &#62;&#62;&#62;</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#AEN4792"
 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 >