Section 3: library functions
FcUtf16Len – count UTF-16 encoded chars Synopsis #include <fontconfig/fontconfig.h> FcBool FcUtf16Len (FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar); Description Counts the number of Unicode chars in len bytes of src. Bytes of src are combined into 16-bit units according to endian. Places that count in nchar. wchar contains 1, 2 or 4…
FcUcs4ToUtf8 – convert UCS4 to UTF-8 Synopsis #include <fontconfig/fontconfig.h> int FcUcs4ToUtf8 (FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN]); Description Converts the Unicode char from src into dst and returns the number of bytes needed to encode the char.
FcToLower – convert upper case ASCII to lower case Synopsis #include <fontconfig/fontconfig.h> FcChar8 FcToLower (FcChar8c); Description This macro converts upper case ASCII c to the equivalent lower case letter.
FcStrStrIgnoreCase – locate UTF-8 substring ignoring ASCII case Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrStrIgnoreCase (const FcChar8 *s1, const FcChar8 *s2); Description Returns the location of s2 in s1, ignoring case. Returns NULL if s2 is not present in s1. This test is case-insensitive for all proper UTF-8 encoded strings.
FcStrStr – locate UTF-8 substring Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrStr (const FcChar8 *s1, const FcChar8 *s2); Description Returns the location of s2 in s1. Returns NULL if s2 is not present in s1. This test will operate properly with UTF8 encoded strings.
FcStrSetMember – check set for membership Synopsis #include <fontconfig/fontconfig.h> FcBool FcStrSetMember (FcStrSet *set, const FcChar8 *s); Description Returns whether s is a member of set.
FcStrSetEqual – check sets for equality Synopsis #include <fontconfig/fontconfig.h> FcBool FcStrSetEqual (FcStrSet *set_a, FcStrSet *set_b); Description Returns whether set_a contains precisely the same strings as set_b. Ordering of strings within the two sets is not considered.
FcStrSetDestroy – destroy a string set Synopsis #include <fontconfig/fontconfig.h> void FcStrSetDestroy (FcStrSet *set); Description Destroys set.
FcStrSetDel – delete from a string set Synopsis #include <fontconfig/fontconfig.h> FcBool FcStrSetDel (FcStrSet *set, const FcChar8 *s); Description Removes s from set, returning FcTrue if s was a member else FcFalse.
FcStrSetCreate – create a string set Synopsis #include <fontconfig/fontconfig.h> FcStrSet * FcStrSetCreate (void); Description Create an empty set.
FcStrSetAddFilename – add a filename to a string set Synopsis #include <fontconfig/fontconfig.h> FcBool FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s); Description Adds a copy s to set, The copy is created with FcStrCopyFilename so that leading ‘~’ values are replaced with the value of the HOME environment variable.
FcStrSetAdd – add to a string set Synopsis #include <fontconfig/fontconfig.h> FcBool FcStrSetAdd (FcStrSet *set, const FcChar8 *s); Description Adds a copy of s to set.
FcStrPlus – concatenate two strings Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcStrPlus (const FcChar8 *s1, const FcChar8 *s2); Description This 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); Description Returns the next string in list.
FcStrListFirst – get first string in iteration Synopsis #include <fontconfig/fontconfig.h> void FcStrListFirst (FcStrList *list); Description Returns the first string in list. Since version 2.11.0
FcStrListDone – destroy a string iterator Synopsis #include <fontconfig/fontconfig.h> void FcStrListDone (FcStrList *list); Description Destroys the enumerator list.
FcStrListCreate – create a string iterator Synopsis #include <fontconfig/fontconfig.h> FcStrList * FcStrListCreate (FcStrSet *set); Description Creates an iterator to list the strings in set.
FcStrFree – free a string Synopsis #include <fontconfig/fontconfig.h> void FcStrFree (FcChar8 *s); Description This 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); Description Allocates 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); Description Returns the directory containing file. This is returned in newly allocated storage which should be freed when no longer needed.