Section 3: library functions
FcStrCopyFilename – create a complete path from a filename Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrCopyFilename (const FcChar8 *s); Description FcStrCopyFilename constructs an absolute pathname from s. It converts any leading ‘~’ characters in to the value of the HOME environment variable, and any relative paths are converted to absolute paths using the current working directory….
FcStrCopy – duplicate a string Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrCopy (const FcChar8 *s); Description Allocates memory, copies s and returns the resulting buffer. Yes, this is strdup, but that function isn’t available on every platform.
FcStrCmpIgnoreCase – compare UTF-8 strings ignoring case Synopsis #include <fontconfig/fontconfig.h> int FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2); Description Returns the usual <0, 0, >0 result of comparing s1 and s2. This test is case-insensitive for all proper UTF-8 encoded strings.
FcStrCmp – compare UTF-8 strings Synopsis #include <fontconfig/fontconfig.h> int FcStrCmp (const FcChar8 *s1, const FcChar8 *s2); Description Returns the usual <0, 0, >0 result of comparing s1 and s2.
FcStrBasename – last component of filename Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrBasename (const FcChar8 *file); Description Returns the filename of file stripped of any leading directory names. This is returned in newly allocated storage which should be freed when no longer needed.
FcRangeGetDouble – Get the range in double Synopsis #include <fontconfig/fontconfig.h> FcBool FcRangeGetDouble (const FcRange *range, double *begin, double *end); Description Returns in begin and end as the range. Since version 2.11.91
FcRangeDestroy – destroy a range object Synopsis #include <fontconfig/fontconfig.h> void FcRangeDestroy (FcRange *range); Description FcRangeDestroy destroys a FcRange object, freeing all memory associated with it. Since version 2.11.91
FcRangeCreateInteger – create a range object for integer Synopsis #include <fontconfig/fontconfig.h> FcRange * FcRangeCreateInteger (intbegin, intend); Description FcRangeCreateInteger creates a new FcRange object with integer sized value. Since version 2.11.91
FcRangeCreateDouble – create a range object for double Synopsis #include <fontconfig/fontconfig.h> FcRange * FcRangeCreateDouble (doublebegin, doubleend); Description FcRangeCreateDouble creates a new FcRange object with double sized value. Since version 2.11.91
FcRangeCopy – Copy a range object Synopsis #include <fontconfig/fontconfig.h> FcRange * FcRangeCopy (const FcRange *range); Description FcRangeCopy creates a new FcRange object and populates it with the contents of range. Since version 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); Description Removes 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); Description Add 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); Description Prints 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); Description Returns the number of the object p has. Since version 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); Description Returns the number of the values in the object which iter point to. if iter isn’t valid, returns 0. Since version 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); Description Initialize iter with the first iterator in p. If there are no objects in p, iter will not have any valid data. Since version 2.13.1
FcPatternIterNext – Synopsis #include <fontconfig/fontconfig.h> FcBool FcPatternIterNext (const FcPattern *p, FcPatternIter *iter); Description Set iter to point to the next object in p and returns FcTrue if iter has been changed to the next object. returns FcFalse otherwise. Since version 2.13.1
FcPatternIterIsValid – Check whether the iterator is valid or not Synopsis #include <fontconfig/fontconfig.h> FcBool FcPatternIterIsValid (const FcPattern *p, FcPatternIter :iter); Description Returns FcTrue if iter point to the valid entry in p. returns FcFalse otherwise. Since version 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); Description Returns 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…
FcPatternIterGetObject – Returns an object name which the iterator point to Synopsis #include <fontconfig/fontconfig.h> const char * FcPatternIterGetObject (const FcPattern *p, FcPatternIter *iter); Description Returns an object name in p which iter point to. returns NULL if iter isn’t valid. Since version 2.13.1