Section 3: library functions
FcCharSetCreate – Create an empty character set Synopsis#include <fontconfig/fontconfig.h> FcCharSet * FcCharSetCreate (void); DescriptionFcCharSetCreate allocates and initializes a new empty character set object.
FcCharSetCoverage – DEPRECATED return coverage for a Unicode page Synopsis#include <fontconfig/fontconfig.h> FcChar32 FcCharSetCoverage (const FcCharSet *a, FcChar32page, FcChar32[8]result); DescriptionDEPRECATED This function returns a bitmask in result which indicates which code points in page are included in a. FcCharSetCoverage returns the next page in the charset which has any coverage.
FcCharSetCount – Count entries in a charset Synopsis#include <fontconfig/fontconfig.h> FcChar32 FcCharSetCount (const FcCharSet *a); DescriptionReturns the total number of Unicode chars in a.
FcCharSetCopy – Copy a charset Synopsis#include <fontconfig/fontconfig.h> FcCharSet * FcCharSetCopy (FcCharSet *src); DescriptionMakes a copy of src; note that this may not actually do anything more than increment the reference count on src.
FcCharSetAddChar – Add a character to a charset Synopsis#include <fontconfig/fontconfig.h> FcBool FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4); DescriptionFcCharSetAddChar adds a single Unicode char to the set, returning FcFalse on failure, either as a result of a constant set or from running out of memory.
FcCacheSubdir – Return the i’th subdirectory. Synopsis#include <fontconfig/fontconfig.h> const FcChar8 * FcCacheSubdir (const FcCache *cache, inti); DescriptionThe set of subdirectories stored in a cache file are indexed by this function, i should range from 0 to n-1, where n is the return value from FcCacheNumSubdir.
FcCacheNumSubdir – Return the number of subdirectories in cache. Synopsis#include <fontconfig/fontconfig.h> int FcCacheNumSubdir (const FcCache *cache); DescriptionThis returns the total number of subdirectories in the cache.
FcCacheNumFont – Returns the number of fonts in cache. Synopsis#include <fontconfig/fontconfig.h> int FcCacheNumFont (const FcCache *cache); DescriptionThis returns the number of fonts which would be included in the return from FcCacheCopySet.
FcCacheDir – Return directory of cache Synopsis#include <fontconfig/fontconfig.h> const FcChar8 * FcCacheDir (const FcCache *cache); DescriptionThis function returns the directory from which the cache was constructed.
FcCacheCreateTagFile – Create CACHEDIR.TAG at cache directory. Synopsis#include <fontconfig/fontconfig.h> void FcCacheCreateTagFile (const FcConfig *config); DescriptionThis tries to create CACHEDIR.TAG file at the cache directory registered to config. Sinceversion 2.9.91
FcCacheCopySet – Returns a copy of the fontset from cache Synopsis#include <fontconfig/fontconfig.h> FcFontSet * FcCacheCopySet (const FcCache *cache); DescriptionThe returned fontset contains each of the font patterns from cache. This fontset may be modified, but the patterns from the cache are read-only.
FcBlanksIsMember – Query membership in an FcBlanks Synopsis#include <fontconfig/fontconfig.h> FcBool FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4); DescriptionFcBlanks is deprecated. This function always returns FALSE.
FcBlanksDestroy – Destroy and FcBlanks Synopsis#include <fontconfig/fontconfig.h> void FcBlanksDestroy (FcBlanks *b); DescriptionFcBlanks is deprecated. This function does nothing.
FcBlanksCreate – Create an FcBlanks Synopsis#include <fontconfig/fontconfig.h> FcBlanks * FcBlanksCreate (void); DescriptionFcBlanks is deprecated. This function always returns NULL.
FcBlanksAdd – Add a character to an FcBlanks Synopsis#include <fontconfig/fontconfig.h> FcBool FcBlanksAdd (FcBlanks *b, FcChar32 ucs4); DescriptionFcBlanks is deprecated. This function always returns FALSE.
FcAtomicUnlock – unlock a file Synopsis#include <fontconfig/fontconfig.h> void FcAtomicUnlock (FcAtomic *atomic); DescriptionUnlocks the file.
FcAtomicReplaceOrig – replace original with new Synopsis#include <fontconfig/fontconfig.h> FcBool FcAtomicReplaceOrig (FcAtomic *atomic); DescriptionReplaces the original file referenced by atomic with the new file. Returns FcFalse if the file cannot be replaced due to permission issues in the filesystem. Otherwise returns FcTrue.
FcAtomicOrigFile – return original file name Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcAtomicOrigFile (FcAtomic *atomic); DescriptionReturns the file referenced by atomic.
FcAtomicNewFile – return new temporary file name Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcAtomicNewFile (FcAtomic *atomic); DescriptionReturns the filename for writing a new version of the file referenced by atomic.
FcAtomicLock – lock a file Synopsis#include <fontconfig/fontconfig.h> FcBool FcAtomicLock (FcAtomic *atomic); DescriptionAttempts to lock the file referenced by atomic. Returns FcFalse if the file is already locked, else returns FcTrue and leaves the file locked.