doc/fontconfig-devel/fcconfigparseandload.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>FcConfigParseAndLoad</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
HREF="t1.html"><LINK
REL="UP"
TITLE="FcConfig"
HREF="x103.html#AEN3038"><LINK
REL="PREVIOUS"
TITLE="FcConfigGetFilename"
HREF="fcconfiggetfilename.html"><LINK
REL="NEXT"
TITLE="FcConfigParseAndLoadFromMemory"
HREF="fcconfigparseandloadfrommemory.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="fcconfiggetfilename.html"
ACCESSKEY="P"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="fcconfigparseandloadfrommemory.html"
ACCESSKEY="N"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="FCCONFIGPARSEANDLOAD"
></A
>FcConfigParseAndLoad</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN3706"
></A
><H2
>Name</H2
>FcConfigParseAndLoad&nbsp;--&nbsp;load a configuration file</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN3709"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><A
NAME="AEN3710"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include &#60;fontconfig/fontconfig.h&#62;
        </PRE
></TD
></TR
></TABLE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>FcBool <TT
CLASS="FUNCTION"
>FcConfigParseAndLoad</TT
></CODE
>(FcConfig *<TT
CLASS="PARAMETER"
><I
>config</I
></TT
>, const FcChar8 *<TT
CLASS="PARAMETER"
><I
>file</I
></TT
>, FcBool <TT
CLASS="PARAMETER"
><I
>complain</I
></TT
>);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3721"
></A
><H2
>Description</H2
><P
>Walks the configuration in 'file' and constructs the internal representation
in 'config'.  Any include files referenced from within 'file' will be loaded
and parsed.  If 'complain' is FcFalse, no warning will be displayed if
'file' does not exist. Error and warning messages will be output to stderr.
Returns FcFalse if some error occurred while loading the file, either a
parse error, semantic error or allocation failure. Otherwise returns FcTrue.

After all configuration files / strings have been loaded, with
<TT
CLASS="FUNCTION"
>FcConfigParseAndLoad</TT
> and/or
<TT
CLASS="FUNCTION"
>FcConfigParseAndLoadFromMemory</TT
>, call
<TT
CLASS="FUNCTION"
>FcConfigBuildFonts</TT
> to build the font
database.
            </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="fcconfiggetfilename.html"
ACCESSKEY="P"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="t1.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="fcconfigparseandloadfrommemory.html"
ACCESSKEY="N"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>FcConfigGetFilename</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="x103.html#AEN3038"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>FcConfigParseAndLoadFromMemory</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>