XListFonts(3X11) X11R5 XListFonts(3X11)NAME
XListFonts, XFreeFontNames, XListFontsWithInfo, XFreeFontInfo - obtain
or free font names and information
SYNTAX
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;
ARGUMENTS
actual_count
Specifies the actual number of matched font names returned by
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.
info_return
Returns the font information.
free_info Specifies the font information returned by
list Specifies the array of strings you want to free.
maxnames Specifies the maximum number of names to be returned.
names Specifies the list of font names returned by
pattern Specifies the null-terminated pattern string that can contain
wildcard characters.
DESCRIPTION
The function returns an array of available font names (as controlled by
the font search path; see that match the string you passed to the pat‐
tern argument. The pattern string can contain any characters, but each
asterisk (*) is a wildcard for any number of characters, and each ques‐
tion mark (?) is a wildcard for a single character. If the pattern
string is not in the Host Portable Character Encoding the result is
implementation dependent. Use of uppercase or lowercase does not mat‐
ter. Each returned string is null-terminated. If the data returned by
the server is in the Latin Portable Character Encoding, then the
returned strings are in the Host Portable Character Encoding. Other‐
wise, the result is implementation dependent. If there are no matching
font names, returns NULL. The client should call when finished with
the result to free the memory.
The function frees the array and strings returned by or
The function returns a list of font names that match the specified pat‐
tern and their associated font information. The list of names is lim‐
ited to size specified by maxnames. The information returned for each
font is identical to what would return except that the per-character
metrics are not returned. The pattern string can contain any charac‐
ters, but each asterisk (*) is a wildcard for any number of characters,
and each question mark (?) is a wildcard for a single character. If
the pattern string is not in the Host Portable Character Encoding the
result is implementation dependent. Use of uppercase or lowercase does
not matter. Each returned string is null-terminated. If the data
returned by the server is in the Latin Portable Character Encoding,
then the returned strings are in the Host Portable Character Encoding.
Otherwise, the result is implementation dependent. If there are no
matching font names, returns NULL.
To free only the allocated name array, the client should call To free
both the name array and the font information array, or to free just the
font information array, the client should call
The function frees the font information array. To free an structure
without closing the font, call with the names argument specified as
NULL.
SEE ALSOXLoadFont(3X11), XSetFontPath(3X11)
Xlib - C Language X Interface
XListFonts(3X11)
