"FcPatternBuild"("3") manual page

Table of Contents

## 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.3.2

Table of Contents

- Name
- Synopsis
- Description
- Version