xcb_list_fonts_reply3
Get matching font names
Part of xcb_list_fonts(3).
Usage
Request function
xcb_list_fonts_cookie_t xcb_list_fonts(xcb_connection_t
*conn,
uint16_t
max_names,
uint16_t
pattern_len,
const
char
*pattern);
Reply datastructure
uint8_t response_type;
uint8_t pad0;
uint16_t sequence;
uint32_t length;
uint16_t names_len;
uint8_t pad1
[22]
;
Reply accessors
int xcb_list_fonts_names_length(const
xcb_list_fonts_reply_t
*reply);
xcb_str_iterator_t xcb_list_fonts_names_iterator(const
xcb_list_fonts_reply_t
*reply);
Request arguments
- conn
-
The XCB connection to X11.
- max_names
-
The maximum number of fonts to be returned.
- pattern_len
-
The length (in bytes) of pattern.
- pattern
-
A font pattern, for example "-misc-fixed-*".
The asterisk (*) is a wildcard for any number of characters. The question mark (?) is a wildcard for a single character. Use of uppercase or lowercase does not matter.
Reply fields
- response_type
-
The type of this reply, in this case XCB_LIST_FONTS. This field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other.
- sequence
-
The sequence number of the last request processed by the X11 server.
- length
-
The length of the reply, in words (a word is 4 bytes).
- names_len
-
The number of font names.
Overview
Gets a list of available font names which match the given pattern.
Return value
Returns an xcb_list_fonts_cookie_t. Errors have to be handled when calling the reply function xcb_list_fonts_reply.
If you want to handle errors in the event loop instead, use xcb_list_fonts_unchecked. See xcb-requests(3) for details.
Errors
This request does never generate any errors.
History
- Arch Linux 2026-11-01 to Debian 13 (Trixie): the text shown here
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
- Debian 9 (Stretch)