xcb_get_selection_owner(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_get_selection_owner — XCB Requests, bestie edition

okay so this is xcb_get_selection_owner(3), a lil XCB request page, and we're gonna learn her together 🫶 she lives in libxcb and she answers exactly one question: who owns this selection rn 👑

✨ NAME ✨

xcb_get_selection_owner — gets the owner of a selection 🌸

🦋 SYNOPSIS 🦋

#include <xcb/xproto.h>

Request function 💖

xcb_get_selection_owner_cookie_t
       xcb_get_selection_owner(xcb_connection_t *conn,
       xcb_atom_t selection);

Reply datastructure 🎀

typedef struct xcb_get_selection_owner_reply_t {
    uint8_t      response_type;
    uint8_t      pad0;
    uint16_t     sequence;
    uint32_t     length;
    xcb_window_t owner;
} xcb_get_selection_owner_reply_t;

Reply function ✨

xcb_get_selection_owner_reply_t
       *xcb_get_selection_owner_reply(xcb_connection_t *conn,
       xcb_get_selection_owner_cookie_t cookie,
       xcb_generic_error_t **e);

🌈 REQUEST ARGUMENTS 🌈

  • conn — the XCB connection to X11, aka your lil hotline to the server 📞
  • selection — the selection. that's it, that's the argument, she's just The Selection 💅

👑 REPLY FIELDS 👑

  • response_type — the type of this reply, and in this case it's XCB_GET_SELECTION_OWNER. this field also lives in the xcb_generic_reply_t, and you can use it to tell replies apart from each other, no cap 🔍
  • sequence — the sequence number of the last request processed by the X11 server 🔢
  • length — the length of the reply, in words. and yes, a word is 4 bytes, periodt 📏
  • owner — the current selection owner window 🪟✨

💜 DESCRIPTION 💜

Gets the owner of the specified selection. simple. iconic. does exactly what it says on the tin 🫶

TODO: briefly explain what a selection is. — yeah bestie, the manpage literally says this, we're not gonna pretend otherwise 😭 iykyk

🔥 RETURN VALUE 🔥

Returns an xcb_get_selection_owner_cookie_t 🍪 errors have to be handled when you call the reply function xcb_get_selection_owner_reply.

If you'd rather handle errors in the event loop instead, use xcb_get_selection_owner_unchecked. See xcb-requests(3) for details 👀

💀 ERRORS 💀

  • xcb_atom_error_t — selection does not refer to a valid atom. not a valid atom, not a vibe, request denied 🙈

🌟 SEE ALSO 🌟

🧚 AUTHOR 🧚

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements 📬 (yes, actual humans, go be helpful 💖)

mwah, that's the whole page bestie, you ate 💅✨ this lil number ships as part of X Version 11, libxcb 1.17.0, and the page is xcb_get_selection_owner(3) — go forth and query some owners, you've got this 🌸🦋🎀

📦 where this page comes from