xcb_list_fonts(3)

📦
version 1.17.0 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 xcb_list_fonts

okay bestie, welcome to xcb_list_fonts from the XCB Requests girlies ✨ this one lives in libxcb (the X protocol binding situation) and it's literally just: "hey server, gimme the font names that match this pattern" 🎀

✨ NAME ✨

xcb_list_fonts — get matching font names 🦋

✨ SYNOPSIS ✨

#include <xcb/xproto.h>

🫶 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

typedef struct xcb_list_fonts_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint16_t names_len;
    uint8_t  pad1[22];
} xcb_list_fonts_reply_t;

🎀 Reply function

xcb_list_fonts_reply_t *xcb_list_fonts_reply(xcb_connection_t *conn,
       xcb_list_fonts_cookie_t cookie, xcb_generic_error_t **e);

💖 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, aka your link to the server, your main character hotline ☎️
  • max_names — the maximum number of fonts to be returned. like, a cap. a limit. a "no more than this many pls" 👑
  • 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, so don't stress abt it bestie 💅

⭐ 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 👀 (iykyk)
  • 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 🍓

💜 DESCRIPTION 💜

gets a list of available font names which match the given pattern. that's it, that's the whole vibe ✨

🔥 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. not me being shocked 😭 iconic behaviour honestly, zero drama, no notes 💅

👑 SEE ALSO 👑

🧚 AUTHOR 🧚

generated from xproto.xml. contact xcb@lists.freedesktop.org for corrections and improvements 💌

okay that's the whole page bestie, you ate 💅 this was xcb_list_fonts(3), brought to you by X Version 11, libxcb 1.17.0 — slay, go forth and list those fonts ✨🎀

📦 where this page comes from