Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

FcPatternBuild (3)

Name

FcPatternBuild - 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

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
              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, 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 FcPat-
       ternVaBuild which returns its result directly in the result variable.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | system/library/fontconfig |
       +---------------+---------------------------+
       |Stability      | Volatile                  |
       +---------------+---------------------------+
NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   https://fontconfig.org/release/fontcon-
       fig-2.12.1.tar.bz2

       Further information about this software can be found on the open source
       community website at https://fontconfig.org/.



Fontconfig 2.12.1                  05 8 2016                 FcPatternBuild(3)