man-pages/man3/FcPatternBuild.3.html
2021-03-31 01:06:50 +01:00

76 lines
2.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of FcPatternBuild</TITLE>
</HEAD><BODY>
<H1>FcPatternBuild</H1>
Section: (3)<BR>Updated: 06 April 2020<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild - Create patterns from arguments
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<B>#include &lt;<A HREF="file:///usr/include/fontconfig/fontconfig.h">fontconfig/fontconfig.h</A>&gt;
<P>
FcPattern * FcPatternBuild (FcPattern *</B><I>pattern</I><B>, ...</B><I></I><B>);
<P>
FcPattern * FcPatternVaBuild (FcPattern *</B><I>pattern</I><B>, va_list </B><I>va</I><B>);
<P>
void FcPatternVapBuild (FcPattern *</B><I>result</I><B>, FcPattern *</B><I>pattern</I><B>, va_list </B><I>va</I><B>);
</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Builds a pattern using a list of objects, types and values. Each
value to be entered in the pattern is specified with three arguments:
<DL COMPACT>
<DT id="1">1. <DD>
Object name, a string describing the property to be added.
<DT id="2">2. <DD>
Object type, one of the FcType enumerated values
<DT id="3">3. <DD>
Value, not an FcValue, but the raw type as passed to any of the
FcPatternAdd&lt;type&gt; functions. Must match the type of the second
argument.
</DL>
<P>
The argument list is terminated by a null object name, no object type nor
value need be passed for this. The values are added to `pattern', if
`pattern' is null, a new pattern is created. In either case, the pattern is
returned. Example
<P>
<PRE>
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, &quot;Times&quot;, (char *) 0);
</PRE>
<P>
FcPatternVaBuild is used when the arguments are already in the form of a
varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
which returns its result directly in the <I>result</I>
variable.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="4"><A HREF="#lbAB">NAME</A><DD>
<DT id="5"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="6"><A HREF="#lbAD">DESCRIPTION</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:42 GMT, March 31, 2021
</BODY>
</HTML>