xcb_input_xi_select_events(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

💖 NAME 💖

xcb_input_xi_select_events — bestie, the description is literally blank, so that's what we're working with 🙈 (no cap, the original page ships with an empty NAME line and we are keeping that energy)

✨ SYNOPSIS ✨

First things first, you gotta bring in the header, okay?

#include <xcb/xinput.h>

🦋 Request function 🦋

xcb_void_cookie_t xcb_input_xi_select_events(xcb_connection_t *conn,
       xcb_window_t window, uint16_t num_mask, const
       xcb_input_event_mask_t *masks);

🎀 REQUEST ARGUMENTS 🎀

  • conn — the XCB connection to X11. That's your lil link to the server, your main character connection 💅
  • window — TODO: NOT YET DOCUMENTED. yeah literally, that's all the docs say, we're not making stuff up 🌸
  • num_mask — TODO: NOT YET DOCUMENTED. same vibe, the page is leaving us on read 😭
  • masks — TODO: NOT YET DOCUMENTED. yep, still a mystery, still const xcb_input_event_mask_t * tho ✨

🌈 DESCRIPTION 🌈

Nothing. Zero. Empty. The DESCRIPTION section is a void, bestie — there is genuinely no prose here in the original, so I'm not about to invent any, that's not the move 🙅‍♀️

👑 RETURN VALUE 👑

It hands you back an xcb_void_cookie_t. And here's the tea: errors (if there are any, which, spoiler, see below) have to be handled in the event loop, okay? That's the deal 🫶

If you'd rather handle errors directly with xcb_request_check instead, then use xcb_input_xi_select_events_checked — that's the checked twin, she's right there 💅

See xcb-requests(3) for all the details, fr fr.

💀 ERRORS 💀

Okay so this is iconic of it:

This request does never generate any errors.

Not a single one. No errors, no drama, no chaos — she's a chill queen 👑✨

🌟 SEE ALSO 🌟

Nothing listed here either. The SEE ALSO section is empty in the original. You're on your own for cross-references, bestie 🦋

🍓 AUTHOR 🍓

Generated from xinput.xml. If you wanna send corrections and improvements, hit up xcb@lists.freedesktop.org — they're the ones who actually take the notes 📩💖

And that's the whole page! Sending you off with the deets: this is from X Version 11, libxcb 1.17.0, and the manual page is xcb_input_xi_select_events(3). slay, go select some events, ily 🧚💜

📦 where this page comes from