Section 3: library functions
FcRangeCopy – Copy a range object Synopsis#include <fontconfig/fontconfig.h> FcRange * FcRangeCopy (const FcRange *range); DescriptionFcRangeCopy creates a new FcRange object and populates it with the contents of range. Sinceversion 2.11.91
FcPatternRemove – Remove one object of the specified type from the pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternRemove (FcPattern *p, const char *object, int id); DescriptionRemoves the value associated with the property `object’ at position `id’, returning whether the property existed and had a value at that position or not.
FcPatternReference – Increment pattern reference count Synopsis#include <fontconfig/fontconfig.h> void FcPatternReference (FcPattern *p); DescriptionAdd another reference to p. Patterns are freed only when the reference count reaches zero.
FcPatternPrint – Print a pattern for debugging Synopsis#include <fontconfig/fontconfig.h> void FcPatternPrint (const FcPattern *p); DescriptionPrints an easily readable version of the pattern to stdout. There is no provision for reparsing data in this format, it’s just for diagnostics and debugging.
FcPatternObjectCount – Returns the number of the object Synopsis#include <fontconfig/fontconfig.h> int FcPatternObjectCount (const FcPattern *p); DescriptionReturns the number of the object p has. Sinceversion 2.13.1
FcPatternIterValueCount – Returns the number of the values which the iterator point to Synopsis#include <fontconfig/fontconfig.h> int FcPatternIterValueCount (const FcPattern *p, FcPatternIter *iter); DescriptionReturns the number of the values in the object which iter point to. if iter isn’t valid, returns 0. Sinceversion 2.13.1
FcPatternIterStart – Initialize the iterator with the first iterator in the pattern Synopsis#include <fontconfig/fontconfig.h> void FcPatternIterStart (const FcPattern *p, FcPatternIter *iter); DescriptionInitialize iter with the first iterator in p. If there are no objects in p, iter will not have any valid data. Sinceversion 2.13.1
FcPatternIterNext – Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternIterNext (const FcPattern *p, FcPatternIter *iter); DescriptionSet iter to point to the next object in p and returns FcTrue if iter has been changed to the next object. returns FcFalse otherwise. Sinceversion 2.13.1
FcPatternIterIsValid – Check whether the iterator is valid or not Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternIterIsValid (const FcPattern *p, FcPatternIter :iter); DescriptionReturns FcTrue if iter point to the valid entry in p. returns FcFalse otherwise. Sinceversion 2.13.1
FcPatternIterGetValue – Returns a value which the iterator point to Synopsis#include <fontconfig/fontconfig.h> FcResult FcPatternIterGetValue (const FcPattern *p, FcPatternIter *iter, intid, FcValue *v, FcValueBinding *b); DescriptionReturns in v the id‘th value which iter point to. also binding to b if given. The value returned is not a copy, but rather refers to the data stored within…
FcPatternIterGetObject – Returns an object name which the iterator point to Synopsis#include <fontconfig/fontconfig.h> const char * FcPatternIterGetObject (const FcPattern *p, FcPatternIter *iter); DescriptionReturns an object name in p which iter point to. returns NULL if iter isn’t valid. Sinceversion 2.13.1
FcPatternIterEqual – Compare iterators Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternIterEqual (const FcPattern *p1, FcPatternIter *i1, const FcPattern *p2, FcPatternIter *i2); DescriptionReturn FcTrue if both i1 and i2 point to same object and contains same values. return FcFalse otherwise. Sinceversion 2.13.1
FcPatternHash – Compute a pattern hash value Synopsis#include <fontconfig/fontconfig.h> FcChar32 FcPatternHash (const FcPattern *p); DescriptionReturns a 32-bit number which is the same for any two patterns which are equal.
FcPatternGetWithBinding – Return a value with binding from a pattern Synopsis#include <fontconfig/fontconfig.h> FcResult FcPatternGetWithBinding (FcPattern *p, const char *object, int id, FcValue *v, FcValueBinding *b); DescriptionReturns in v the id‘th value and b binding for that associated with the property object. The Value returned is not a copy, but rather refers to the data stored…
FcPatternGet – Return a value from a pattern Synopsis#include <fontconfig/fontconfig.h> FcResult FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v); DescriptionReturns in v the id‘th value associated with the property object. The value returned is not a copy, but rather refers to the data stored within the pattern directly. Applications must not free this…
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool, FcPatternGetFTFace, FcPatternGetLangSet, FcPatternGetRange – Return a typed value from a pattern Synopsis#include <fontconfig/fontconfig.h> FcResult FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i); FcResult FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d); FcResult FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 **s); FcResult FcPatternGetMatrix (FcPattern…
FcPatternFormat – Format a pattern into a string according to a format specifier Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcPatternFormat (FcPattern *pat, const FcChar8 *format); DescriptionConverts given pattern pat into text described by the format specifier format. The return value refers to newly allocated memory which should be freed by the caller using free(), or NULL if…
FcPatternFindIter – Set the iterator to point to the object in the pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternFindIter (const FcPattern *p, FcPatternIter *iter, const char *object); DescriptionSet iter to point to object in p if any and returns FcTrue. returns FcFalse otherwise. Sinceversion 2.13.1
FcPatternFilter – Filter the objects of pattern Synopsis#include <fontconfig/fontconfig.h> FcPattern * FcPatternFilter (FcPattern *p, const FcObjectSet *); DescriptionReturns a new pattern that only has those objects from p that are in os. If os is NULL, a duplicate of p is returned.
FcPatternEqualSubset – Compare portions of patterns Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os); DescriptionReturns whether pa and pb have exactly the same values for all of the objects in os.