FcPatternBuild(3)                               FcPatternBuild(3)



NAME
       FcPatternBuild,  FcPatternVaBuild  -  Create patterns from
       arguments

SYNOPSIS
       #include 

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

       FcPattern *  FcPatternVaBuild  (FcPattern  *orig,  va_list
       va);


DESCRIPTION
       Builds  a  pattern using a list of objects, types and val-
       ues.  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 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  pat-
       tern is created.  In either case, the pattern is returned.
       Example

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

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

VERSION
       Fontconfig version 2.4.2



                         02 December 2006       FcPatternBuild(3)