Section 3: library functions
FcLangSetSubtract – Subtract langsets Synopsis #include <fontconfig/fontconfig.h> FcLangSet * FcLangSetSubtract (const FcLangSet *ls_a, const FcLangSet *ls_b); Description Returns a set including only those languages found in ls_a but not in ls_b. Since version 2.9.0
FcLangSetHash – return a hash value for a langset Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcLangSetHash (const FcLangSet *ls); Description This function returns a value which depends solely on the languages supported by ls. Any language which equals ls will have the same result from FcLangSetHash. However, two langsets with the same hash value may not be…
FcLangSetHasLang – test langset for language support Synopsis #include <fontconfig/fontconfig.h> FcLangResult FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang); Description FcLangSetHasLang checks whether ls supports lang. If ls has a matching language and territory pair, this function returns FcLangEqual. If ls has a matching language but differs in which territory that language is for, this function…
FcLangSetGetLangs – get the list of languages in the langset Synopsis #include <fontconfig/fontconfig.h> FcStrSet * FcLangSetGetLangs (const FcLangSet *ls); Description Returns a string set of all languages in langset.
FcLangSetEqual – test for matching langsets Synopsis #include <fontconfig/fontconfig.h> FcBool FcLangSetEqual (const FcLangSet *ls_a, const FcLangSet *ls_b); Description Returns FcTrue if and only if ls_a supports precisely the same language and territory combinations as ls_b.
FcLangSetDestroy – destroy a langset object Synopsis #include <fontconfig/fontconfig.h> void FcLangSetDestroy (FcLangSet *ls); Description FcLangSetDestroy destroys a FcLangSet object, freeing all memory associated with it.
FcLangSetDel – delete a language from a langset Synopsis #include <fontconfig/fontconfig.h> FcBool FcLangSetDel (FcLangSet *ls, const FcChar8 *lang); Description lang is removed from ls. lang should be of the form Ll-Tt where Ll is a two or three letter language from ISO 639 and Tt is a territory from ISO 3166. Since version 2.9.0
FcLangSetCreate – create a langset object Synopsis #include <fontconfig/fontconfig.h> FcLangSet * FcLangSetCreate (void); Description FcLangSetCreate creates a new FcLangSet object.
FcLangSetCopy – copy a langset object Synopsis #include <fontconfig/fontconfig.h> FcLangSet * FcLangSetCopy (const FcLangSet *ls); Description FcLangSetCopy creates a new FcLangSet object and populates it with the contents of ls.
FcLangSetContains – check langset subset relation Synopsis #include <fontconfig/fontconfig.h> FcBool FcLangSetContains (const FcLangSet *ls_a, const FcLangSet *ls_b); Description FcLangSetContains returns FcTrue if ls_a contains every language in ls_b. ls_a will ‘contain’ a language from ls_b if ls_a has exactly the language, or either the language or ls_a has no territory.
FcLangSetCompare – compare language sets Synopsis #include <fontconfig/fontconfig.h> FcLangResult FcLangSetCompare (const FcLangSet *ls_a, const FcLangSet *ls_b); Description FcLangSetCompare compares language coverage for ls_a and ls_b. If they share any language and territory pair, this function returns FcLangEqual. If they share a language but differ in which territory that language is for, this function returns FcLangDifferentTerritory….
FcLangSetAdd – add a language to a langset Synopsis #include <fontconfig/fontconfig.h> FcBool FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang); Description lang is added to ls. lang should be of the form Ll-Tt where Ll is a two or three letter language from ISO 639 and Tt is a territory from ISO 3166.
FcLangNormalize – Normalize the language string Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcLangNormalize (const FcChar8 *lang); Description Returns a string to make lang suitable on fontconfig. Since version 2.10.91
FcLangGetCharSet – Get character map for a language Synopsis #include <fontconfig/fontconfig.h> const FcCharSet * FcLangGetCharSet (const FcChar8 *lang); Description Returns the FcCharMap for a language.
FcIsUpper – check for upper case ASCII character Synopsis #include <fontconfig/fontconfig.h> FcBool FcIsUpper (FcChar8c); Description This macro checks whether c is a upper case ASCII letter.
FcIsLower – check for lower case ASCII character Synopsis #include <fontconfig/fontconfig.h> FcBool FcIsLower (FcChar8c); Description This macro checks whether c is an lower case ASCII letter.
FcInitReinitialize – re-initialize library Synopsis #include <fontconfig/fontconfig.h> FcBool FcInitReinitialize (void); Description Forces the default configuration file to be reloaded and resets the default configuration. Returns FcFalse if the configuration cannot be reloaded (due to configuration file errors, allocation failures or other issues) and leaves the existing configuration unchanged. Otherwise returns FcTrue.
FcInitLoadConfigAndFonts – load configuration and font data Synopsis #include <fontconfig/fontconfig.h> FcConfig * FcInitLoadConfigAndFonts (void); Description Loads the default configuration file and builds information about the available fonts. Returns the resulting configuration.
FcInitLoadConfig – load configuration Synopsis #include <fontconfig/fontconfig.h> FcConfig * FcInitLoadConfig (void); Description Loads the default configuration file and returns the resulting configuration. Does not load any font information.
FcInitBringUptoDate – reload configuration files if needed Synopsis #include <fontconfig/fontconfig.h> FcBool FcInitBringUptoDate (void); Description Checks the rescan interval in the default configuration, checking the configuration if the interval has passed and reloading the configuration if when any changes are detected. Returns FcFalse if the configuration cannot be reloaded (see FcInitReinitialize). Otherwise returns FcTrue.