Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FcPatternBuild(3)					       FcPatternBuild(3)

NAME
     FcPatternBuild,  FcPatternVaBuild, FcPatternVapBuild - Create patterns from
     arguments

SYNOPSIS
     #include <fontconfig/fontconfig.h>

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

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

     void FcPatternVapBuild (FcPattern *result, FcPattern *pattern, va_list va);

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 Fc-
	    PatternAdd<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 `pattern', if  `pat-
     tern' is null, a new pattern is created. In either case, the pattern is re-
     turned. 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. FcPatternVapBuild is a  macro  version  of	FcPatternVaBuild
     which returns its result directly in the result variable.

Fontconfig 2.17.1		  02 July 2025		       FcPatternBuild(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=FcPatternBuild&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help