FcPatternBuild

a b c d e f g h i j k l m n o p q r s t u v w x y z _
FcPatternBuild(3)					    FcPatternBuild(3)



NAME
       FcPatternBuild, FcPatternVaBuild - Create patterns from arguments

SYNOPSIS
       #include <fontconfig.h>

       FcPattern * FcPatternBuild (FcPattern *orig, ...);

       FcPattern * FcPatternVaBuild (FcPattern *orig, va_listva);

DESCRIPTION
       Builds  a  pattern  using  a  list of objects, types and values.	 Each
       value to be entered in the pattern is specified with three arguments:

       1. Object name, a string describing the property to be added.

       2. Object type, one of the FcType enumerated values

       3. Value, not an FcValue, but the raw type as passed  to	 any  of  the
	  FcPatternAdd<type>  functions.   Must	 match the type of the second
	  argument.

       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

       pattern = FcPatternBuild (0, FC_FAMILY, FtTypeString, "Times", (char *) 0);

       FcPatternVaBuild is used when the arguments are already in the form of
       a varargs value.

VERSION
       Fontconfig version 2.2.3



				 30 June 2004		    FcPatternBuild(3)