ufmGetFontPath(3w)

NAME
     ufmGetFontPath - get the current UFM font path

C SYNOPSIS
     #include <ufm.h>

     int ufmGetFontPath(char **fontPath)

DESCRIPTION
     ufmGetFontPath gets the current Universal Font Manager (UFM) font path.

     ufmGetFontPath uses the argument fontPath to return a pointer to a null-
     terminated character string that represents the current UFM font path.
     That path is used by UFM to find font files.  If an error is detected,
     ufmGetFontPath sets that pointer to NULL.

     The UFM font path contains one or more full-path names of font
     directories.  On platforms with the X Window System, each specified
     directory must exist, and it must contain a fonts.dir file (a directory
     of font files).  If there is more than one full-path directory name, put
     a comma (,) after each directory name, except the last one.  UFM searches
     font directories in the order in which they are specified in the font
     path.

     There is a default UFM font path.  The default UFM font path can be
     changed by calling the function ufmSetFontPath.  When your program is
     finished with the UFM font path, it can call the function ufmFree with
     the pointer fontPath.  ufmFree will free the memory which was allocated
     for a copy of the UFM font path.

SEE ALSO
     ufmFree(3w), ufmSetFontPath(3w).

DIAGNOSTICS
     If ufmGetFontPath is not able to allocate the memory it needs, it will
     return the value UFM_OUT_OF_MEMORY.  Else, it returns the value
     UFM_NO_ERROR.  UFM_OUT_OF_MEMORY and UFM_NO_ERROR are defined in the
     header file <ufm.h>.