XFreeFontInfo(3)



XListFonts

NAME
SYNTAX
ARGUMENTS
DESCRIPTION
SEE ALSO

NAME

XListFonts, XFreeFontNames, XListFontsWithInfo, XFreeFontInfo − obtain or free font names and information

SYNTAX

char **XListFonts(Display *display, char *pattern, int maxnames, int *actual_count_return);

int XFreeFontNames(char *list[]);

char **XListFontsWithInfo(Display *display, char *pattern, int maxnames, int *count_return, XFontStruct **info_return);

int XFreeFontInfo(char **names, XFontStruct *free_info, int actual_count);

ARGUMENTS

actual_count

Specifies the actual number of font names.

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.

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.

pattern

Specifies the null-terminated pattern string that can contain wildcard characters.

DESCRIPTION

The XListFonts function returns an array of available font names (as controlled by the font search path; see XSetFontPath) that match the string you passed to the pattern argument. 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. 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, XListFonts returns NULL. The client should call XFreeFontNames when finished with the result to free the memory.

The XFreeFontNames function frees the array and strings returned 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. 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, XListFontsWithInfo returns NULL.

To free only the allocated name array, the client should call XFreeFontNames. To free both the name array and the font information array or to free just the font information array, the client should call XFreeFontInfo.

The XFreeFontInfo function frees a font structure or an array of font structures and optionally an array of font names. If NULL is passed for names, no font names are freed. If a font structure for an open font (returned by XLoadQueryFont) is passed, the structure is freed, but the font is not closed; use XUnloadFont to close the font.

Note that XListFontsWithInfo is not thread-safe. If other threads make X requests on the same Display, then this function’s behavior is undefined.

SEE ALSO

XLoadFont(3), XSetFontPath(3)
Xlib − C Language X Interface



More Linux Commands

manpages/glIsTexture.3gl.html
glIsTexture(3gl) - determine if a name corresponds to a text
glIsTexture returns GL_TRUE if texture is currently the name of a texture. If texture is zero, or is a non-zero value that is not currently the name of a textur

manpages/XML::LibXML::Number.3pm.html
XML::LibXML::Number(3pm) - Simple numeric values. (ManPage)
XML::LibXML::Number.3pm - This class holds simple numeric values. It doesnt support -0, +/- Infinity, or NaN, as the XPath spec says it should, but Im not hurti

manpages/xrestop.1.html
xrestop(1) - monitor server resources used by X11 clients...
Xrestop uses the X-Resource extension to provide top-like statistics of each connected X11 clients server-side resource usage. It is intended as a developer too

manpages/glColor4uiv.3gl.html
glColor4uiv(3gl) - set the current color - Linux man page...
The GL stores both a current single-valued color index and a current four-valued RGBA color. glColor sets a new four-valued RGBA color. glColor has two major va

manpages/slk_attron.3ncurses.html
slk_attron(3ncurses) - curses soft label routines (ManPage)
The slk* functions manipulate the set of soft function-key labels that exist on many terminals. For those terminals that do not have soft labels, curses takes o

manpages/wdeleteln.3ncurses.html
wdeleteln(3ncurses) - delete and insert lines in a curses wi
The deleteln and wdeleteln routines delete the line under the cursor in the window; all lines below the current line are moved up one line. The bottom line of t

manpages/pong.6x.html
pong(6x) - Pong Home Video Game Emulator - Linux man page...
The pong program simulates an ancient Pong home video game, as well as various artifacts from displaying it on a color TV set. OPTIONS pong accepts the followin

manpages/aa_getcon.2.html
aa_getcon(2) - get task confinement information (Man Page)
The aa_getcon function gets the current AppArmor confinement context for the current task. The confinement context is usually just the name of the AppArmor prof

manpages/X11::Protocol::Connection::INETFH.3pm.html
X11::Protocol::Connection::INETFH.3pm.......................
This module is used by X11::Protocol to establish a connection and communicate with a server over an internet-type TCP/IP socket connection, using the FileHandl

manpages/gnutls_certificate_set_x509_simple_pkcs12_file.3.html
gnutls_certificate_set_x509_simple_pkcs12_file.3............
gnutls_certificate_set_x509_simple_pkcs12_file.3 - This function sets a certificate/private key pair and/or a CRL in the gnutls_certificate_credentials_t struct

manpages/mount.8.html
mount(8) - mount a filesystem (Admin - Linux man page)......
All files accessible in a Unix system are arranged in one big tree, the file hierarchy, rooted at /. These files can be spread out over several devices. The mou

manpages/ldap_dn2str.3.html
ldap_dn2str(3) - LDAP DN handling routines - Linux man page
These routines allow LDAP entry names (Distinguished Names, or DNs) to be obtained, parsed, converted to a user-friendly form, and tested. A DN has the form des





We can't live, work or learn in freedom unless the software we use is free.