Section 3: library functions
FcValueSave – Copy a value Synopsis#include <fontconfig/fontconfig.h> FcValue FcValueSave (FcValue v); DescriptionReturns a copy of v duplicating any object referenced by it so that v may be safely destroyed without harming the new value.
FcValuePrint – Print a value to stdout Synopsis#include <fontconfig/fontconfig.h> void FcValuePrint (FcValue v); DescriptionPrints a human-readable representation of v to stdout. The format should not be considered part of the library specification as it may change in the future.
FcValueEqual – Test two values for equality Synopsis#include <fontconfig/fontconfig.h> FcBool FcValueEqual (FcValue v_a, FcValue v_b); DescriptionCompares two values. Integers and Doubles are compared as numbers; otherwise the two values have to be the same type to be considered equal. Strings are compared ignoring case.
FcValueDestroy – Free a value Synopsis#include <fontconfig/fontconfig.h> void FcValueDestroy (FcValue v); DescriptionFrees any memory referenced by v. Values of type FcTypeString, FcTypeMatrix and FcTypeCharSet reference memory, the other types do not.
FcUtf8ToUcs4 – convert UTF-8 to UCS4 Synopsis#include <fontconfig/fontconfig.h> int FcUtf8ToUcs4 (FcChar8 *src, FcChar32 *dst, int len); DescriptionConverts the next Unicode char from src into dst and returns the number of bytes containing the char. src must be at least len bytes long.
FcUtf8Len – count UTF-8 encoded chars Synopsis#include <fontconfig/fontconfig.h> FcBool FcUtf8Len (FcChar8 *src, int len, int *nchar, int *wchar); DescriptionCounts the number of Unicode chars in len bytes of src. Places that count in nchar. wchar contains 1, 2 or 4 depending on the number of bytes needed to hold the largest Unicode char counted. The…
FcUtf16ToUcs4 – convert UTF-16 to UCS4 Synopsis#include <fontconfig/fontconfig.h> int FcUtf16ToUcs4 (FcChar8 *src, FcEndian endian, FcChar32 *dst, int len); DescriptionConverts the next Unicode char from src into dst and returns the number of bytes containing the char. src must be at least len bytes long. Bytes of src are combined into 16-bit units according to endian.
FcUtf16Len – count UTF-16 encoded chars Synopsis#include <fontconfig/fontconfig.h> FcBool FcUtf16Len (FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar); DescriptionCounts 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 depending on…
FcUcs4ToUtf8 – convert UCS4 to UTF-8 Synopsis#include <fontconfig/fontconfig.h> int FcUcs4ToUtf8 (FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN]); DescriptionConverts 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); DescriptionThis 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionDestroys set.
FcStrSetDel – delete from a string set Synopsis#include <fontconfig/fontconfig.h> FcBool FcStrSetDel (FcStrSet *set, const FcChar8 *s); DescriptionRemoves 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); DescriptionCreate an empty set.
FcStrSetAddFilename – add a filename to a string set Synopsis#include <fontconfig/fontconfig.h> FcBool FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s); DescriptionAdds 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); DescriptionAdds a copy of s to set.
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.