fcconfigfilename.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>FcConfigFilename</TITLE 6><META 7NAME="GENERATOR" 8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9REL="HOME" 10HREF="t1.html"><LINK 11REL="UP" 12TITLE="FcConfig" 13HREF="x102.html#AEN2679"><LINK 14REL="PREVIOUS" 15TITLE="FcFontList" 16HREF="fcfontlist.html"><LINK 17REL="NEXT" 18TITLE="FcConfigParseAndLoad" 19HREF="fcconfigparseandload.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="fcfontlist.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="fcconfigparseandload.html" 62ACCESSKEY="N" 63>Next >>></A 64></TD 65></TR 66></TABLE 67><HR 68ALIGN="LEFT" 69WIDTH="100%"></DIV 70><H1 71><A 72NAME="FCCONFIGFILENAME" 73></A 74>FcConfigFilename</H1 75><DIV 76CLASS="REFNAMEDIV" 77><A 78NAME="AEN3347" 79></A 80><H2 81>Name</H2 82>FcConfigFilename -- Find a config file</DIV 83><DIV 84CLASS="REFSYNOPSISDIV" 85><A 86NAME="AEN3350" 87></A 88><H2 89>Synopsis</H2 90><DIV 91CLASS="FUNCSYNOPSIS" 92><P 93></P 94><A 95NAME="AEN3351" 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>FcConfigFilename</TT 117></CODE 118>(const FcChar8 *<TT 119CLASS="PARAMETER" 120><I 121>name</I 122></TT 123>);</CODE 124></P 125><P 126></P 127></DIV 128></DIV 129><DIV 130CLASS="REFSECT1" 131><A 132NAME="AEN3358" 133></A 134><H2 135>Description</H2 136><P 137>Given the specified external entity name, return the associated filename. 138This provides applications a way to convert various configuration file 139references into filename form. 140 </P 141><P 142>A null or empty <TT 143CLASS="PARAMETER" 144><I 145>name</I 146></TT 147> indicates that the default configuration file should 148be used; which file this references can be overridden with the 149FONTCONFIG_FILE environment variable. Next, if the name starts with <TT 150CLASS="PARAMETER" 151><I 152>~</I 153></TT 154>, it 155refers to a file in the current users home directory. Otherwise if the name 156doesn't start with '/', it refers to a file in the default configuration 157directory; the built-in default directory can be overridden with the 158FONTCONFIG_PATH environment variable. 159 </P 160></DIV 161><DIV 162CLASS="REFSECT1" 163><A 164NAME="AEN3364" 165></A 166><H2 167>Version</H2 168><P 169>Fontconfig version 2.10.93 170 171 </P 172></DIV 173><DIV 174CLASS="NAVFOOTER" 175><HR 176ALIGN="LEFT" 177WIDTH="100%"><TABLE 178SUMMARY="Footer navigation table" 179WIDTH="100%" 180BORDER="0" 181CELLPADDING="0" 182CELLSPACING="0" 183><TR 184><TD 185WIDTH="33%" 186ALIGN="left" 187VALIGN="top" 188><A 189HREF="fcfontlist.html" 190ACCESSKEY="P" 191><<< Previous</A 192></TD 193><TD 194WIDTH="34%" 195ALIGN="center" 196VALIGN="top" 197><A 198HREF="t1.html" 199ACCESSKEY="H" 200>Home</A 201></TD 202><TD 203WIDTH="33%" 204ALIGN="right" 205VALIGN="top" 206><A 207HREF="fcconfigparseandload.html" 208ACCESSKEY="N" 209>Next >>></A 210></TD 211></TR 212><TR 213><TD 214WIDTH="33%" 215ALIGN="left" 216VALIGN="top" 217>FcFontList</TD 218><TD 219WIDTH="34%" 220ALIGN="center" 221VALIGN="top" 222><A 223HREF="x102.html#AEN2679" 224ACCESSKEY="U" 225>Up</A 226></TD 227><TD 228WIDTH="33%" 229ALIGN="right" 230VALIGN="top" 231>FcConfigParseAndLoad</TD 232></TR 233></TABLE 234></DIV 235></BODY 236></HTML 237>