suse man page for fcpatternbuild

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 argu-
	  ment.

       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  `pat-
       tern', if `pattern' is null, a new pattern 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.1

								  16 October 2006						 FcPatternBuild(3)