XListFonts(3X)                                     XListFonts(3X)



NAME
     XListFonts, XFreeFontNames, XListFontsWithInfo,
     XFreeFontInfo - get and free font names and font information

SYNOPSIS
     char **XListFonts (display, pattern, maxnames,
     actual-count-return)
     Display *display;
     char *pattern;
     int maxnames;
     int *actual-count-return;

     XFreeFontNames (list)
     char *list[];

     char **XListFontsWithInfo (display, pattern, maxnames,
     count-return, info-return)
     Display *display;
     char *pattern;
     int maxnames;
     int *count-return;
     XFontStruct **info-return;

     XFreeFontInfo (names, free-info, actual-count)
     char **names;
     XFontStruct *free-info;
     int actual-count;

DESCRIPTION
     The XListFonts function returns an array of available font
     names (as controlled by the font search path; refer to
     XSetFontPath) that match the string you pass to the pattern
     argument.  The string should be ISO Latin-1; case does not
     matter.  Each string is terminated by an ASCII null.  The
     string can contain any characters, but each asterisk (*) is
     a wildcard for any number of characters, and each question
     mark (?) is a wildcard for a single character.  The client
     should call XFreeFontNames when finished with the result to
     free the memory.

     The XFreeFontNames function frees the array and strings re-
     turned by XListFonts or XListFontsWithInfo.

     The XListFontsWithInfo function returns a list of font names
     that match the specified pattern and their associated font
     information.  The list of names is limited to size specified
     by maxnames.  The information returned for each font is
     identical to what XLoadQueryFont would return except that
     the per-character metrics are not returned.  The pattern
     string can contain any characters, but each asterisk (*) is
     a wildcard for any number of characters, and each question
     mark (?) is a wildcard for a single character.  To free the



November, 1990                                                  1

XListFonts(3X)                                     XListFonts(3X)



     allocated name array, the client should call XFreeFontNames.
     To free the the font information array, the client should
     call XFreeFontInfo.

     The XFreeFontInfo function frees the font information array.
     To free an XFontStruct structure without closing the font,
     call XFreeFontInfo with the names argument specified as
     NULL.

   Arguments
     These functions accept the following arguments:

     actual-count
             Specifies the actual number of matched font names
             returned by XListFontsWithInfo.

     actual-count-return
             Returns the actual number of font names.

     count-return
             Returns the actual number of matched font names.

     display Specifies the connection to the X server.

     free-info
             Specifies the pointer to the font information re-
             turned by XListFontsWithInfo.

     info-return
             Returns a pointer to the font information.

     list    Specifies the array of strings to be freed.

     maxnames
             Specifies the maximum number of names to be re-
             turned.

     names   Specifies the list of font names returned by
             XListFontsWithInfo.

     pattern Specifies a null-terminated pattern string that
             selects the font names to be returned.  You can
             specify any string, an asterisk (*), or a question
             mark (?).  The asterisk indicates a wildcard for any
             number of characters, and the question mark indi-
             cates a wildcard for a single character.

SEE ALSO
     XLoadFont(3X), XSetFontPath(3X)

     Xlib - C Language Interface





2                                                  November, 1990