1FcPatternBuild(3) FcPatternBuild(3)
2
3
4
6 FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild - Create patterns
7 from arguments
8
10 #include <fontconfig/fontconfig.h>
11
12 FcPattern * FcPatternBuild (FcPattern *pattern, ...);
13
14 FcPattern * FcPatternVaBuild (FcPattern *pattern, va_list va);
15
16 void FcPatternVapBuild (FcPattern *result, FcPattern *pattern, va_list va);
17
19 Builds a pattern using a list of objects, types and values. Each value
20 to be entered in the pattern is specified with three arguments:
21
22 1. Object name, a string describing the property to be added.
23
24 2. Object type, one of the FcType enumerated values
25
26 3. Value, not an FcValue, but the raw type as passed to any of the
27 FcPatternAdd<type> functions. Must match the type of the second
28 argument.
29
30 The argument list is terminated by a null object name, no object type
31 nor value need be passed for this. The values are added to `pattern',
32 if `pattern' is null, a new pattern is created. In either case, the
33 pattern is returned. Example
34
35 pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
36
37
38 FcPatternVaBuild is used when the arguments are already in the form of
39 a varargs value. FcPatternVapBuild is a macro version of FcPat‐
40 ternVaBuild which returns its result directly in the result variable.
41
42Fontconfig 2.13.94 29 6月 2021 FcPatternBuild(3)