xcb_xevie_select_input(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_xevie_select_input 🌸

okay bestie, gather round, because we're looking at a page from XCB Requests β€” the xcb_xevie_select_input manual, to be exact. yes it's a mouthful, no you don't have to say it out loud. it lives in the libxcb world and it's one of those "small but mighty" request pages. let's get into it πŸ’…


✨ NAME ✨

xcb_xevie_select_input β€” and that's literally it, the description slot is empty, the void, the silence. iconic behaviour honestly. it's the XEvIE "select input" request and we move on 🫢


πŸ¦‹ SYNOPSIS πŸ¦‹

first things first, you gotta bring in the header:

#include <xcb/xevie.h>

πŸ’– Request function πŸ’–

xcb_xevie_select_input_cookie_t
       xcb_xevie_select_input(xcb_connection_t *conn,
       uint32_t event_mask);

πŸŽ€ Reply datastructure πŸŽ€

typedef struct xcb_xevie_select_input_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint8_t  pad1[24];
} xcb_xevie_select_input_reply_t;

🌈 Reply function 🌈

xcb_xevie_select_input_reply_t
       *xcb_xevie_select_input_reply(xcb_connection_t *conn,
       xcb_xevie_select_input_cookie_t cookie, xcb_generic_error_t **e);

πŸ’œ REQUEST ARGUMENTS πŸ’œ

  • conn β€” the XCB connection to X11. your lil phone line to the server, no cap ☎️
  • event_mask β€” TODO: NOT YET DOCUMENTED. yeah. that's the whole thing. the docs said "we'll get to it" and then did not get to it 😭 not me reading a TODO in a real manpage fr fr

⭐ REPLY FIELDS ⭐

  • response_type β€” the type of this reply, which in this case is XCB_XEVIE_SELECT_INPUT. this field is also chillin' inside the xcb_generic_reply_t, so you can use it to tell replies apart from each other. it's giving "name tag at the party" 🏷️
  • sequence β€” the sequence number of the last request processed by the X11 server. lowkey the receipts of who did what and when πŸ“‹
  • length β€” the length of the reply, in words. and reminder bestie: a word is 4 bytes. periodt.

🧚 DESCRIPTION 🧚

nothing here. empty. a blank space. the page simply does not describe it. we respect the mystery πŸ’€


πŸ‘‘ RETURN VALUE πŸ‘‘

so this one returns an xcb_xevie_select_input_cookie_t. a cookie!! πŸͺ and like any good cookie, the errors are a whole separate thing β€” you have to handle them when you call the reply function, xcb_xevie_select_input_reply.

and if you'd rather catch your errors in the event loop instead of at reply time, you use xcb_xevie_select_input_unchecked instead. see xcb-requests(3) for the deets, because that page has the whole explanation and I am not about to make things up ✨


πŸ”₯ ERRORS πŸ”₯

good news, bestie: this request does never generate any errors. zero. none. clean run, main character energy, we love to see it πŸ’–


πŸ¦„ SEE ALSO πŸ¦„

nothing listed. the "see also" section is out here with no plans and no commitments. respect 🌸


πŸ“ AUTHOR πŸ“

Generated from xevie.xml. want corrections or improvements? contact xcb@lists.freedesktop.org β€” they're the ones who can actually do something about it, not me πŸ™ˆ


and that's the whole page, bestie, you ate it 🫢 this was xcb_xevie_select_input(3) from X Version 11, libxcb 1.17.0 β€” go forth, select some input, and stay iconic πŸ’…βœ¨πŸŽ€