Section 3: library functions
FcStrPlus – concatenate two strings Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrPlus (const FcChar8 *s1, const FcChar8 *s2); DescriptionThis function allocates new storage and places the concatenation of s1 and s2 there, returning the new string.
FcStrListNext – get next string in iteration Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrListNext (FcStrList *list); DescriptionReturns the next string in list.
FcStrListFirst – get first string in iteration Synopsis#include <fontconfig/fontconfig.h> void FcStrListFirst (FcStrList *list); DescriptionReturns the first string in list. Sinceversion 2.11.0
FcStrListDone – destroy a string iterator Synopsis#include <fontconfig/fontconfig.h> void FcStrListDone (FcStrList *list); DescriptionDestroys the enumerator list.
FcStrListCreate – create a string iterator Synopsis#include <fontconfig/fontconfig.h> FcStrList * FcStrListCreate (FcStrSet *set); DescriptionCreates an iterator to list the strings in set.
FcStrFree – free a string Synopsis#include <fontconfig/fontconfig.h> void FcStrFree (FcChar8 *s); DescriptionThis is just a wrapper around free(3) which helps track memory usage of strings within the fontconfig library.
FcStrDowncase – create a lower case translation of a string Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrDowncase (const FcChar8 *s); DescriptionAllocates memory, copies s, converting upper case letters to lower case and returns the allocated buffer.
FcStrDirname – directory part of filename Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrDirname (const FcChar8 *file); DescriptionReturns the directory containing file. This is returned in newly allocated storage which should be freed when no longer needed.
FcStrCopyFilename – create a complete path from a filename Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrCopyFilename (const FcChar8 *s); DescriptionFcStrCopyFilename 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. Sequences of…
FcStrCopy – duplicate a string Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcStrCopy (const FcChar8 *s); DescriptionAllocates 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns in begin and end as the range. Sinceversion 2.11.91
FcRangeDestroy – destroy a range object Synopsis#include <fontconfig/fontconfig.h> void FcRangeDestroy (FcRange *range); DescriptionFcRangeDestroy destroys a FcRange object, freeing all memory associated with it. Sinceversion 2.11.91
FcRangeCreateInteger – create a range object for integer Synopsis#include <fontconfig/fontconfig.h> FcRange * FcRangeCreateInteger (intbegin, intend); DescriptionFcRangeCreateInteger creates a new FcRange object with integer sized value. Sinceversion 2.11.91
FcRangeCreateDouble – create a range object for double Synopsis#include <fontconfig/fontconfig.h> FcRange * FcRangeCreateDouble (doublebegin, doubleend); DescriptionFcRangeCreateDouble creates a new FcRange object with double sized value. Sinceversion 2.11.91
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.