xcb_xinerama_query_screens(3)

💖 xcb_xinerama_query_screens — bestie edition 💖

okay so this is a page from XCB Requests, and it's literally all about xcb_xinerama_query_screens(3). yes the NAME section is empty, don't come for me, that's just how it is 🙈

---

✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/xinerama.h>

🎀 Request function

xcb_xinerama_query_screens_cookie_t
       xcb_xinerama_query_screens(xcb_connection_t *conn,

🦋 Reply datastructure

typedef struct xcb_xinerama_query_screens_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t number;
    uint8_t  pad1[20];
} xcb_xinerama_query_screens_reply_t;

🌸 Reply function

xcb_xinerama_query_screens_reply_t
       *xcb_xinerama_query_screens_reply(xcb_connection_t *conn,
       xcb_xinerama_query_screens_cookie_t cookie,
       xcb_generic_error_t **e);

💅 Reply accessors

xcb_xinerama_screen_info_t *xcb_xinerama_query_screens_screen_info(const
       xcb_xinerama_query_screens_request_t *reply);

int xcb_xinerama_query_screens_screen_info_length(const
       xcb_xinerama_query_screens_reply_t *reply);

xcb_xinerama_screen_info_iterator_t
       xcb_xinerama_query_screens_screen_info_iterator(const
       xcb_xinerama_query_screens_reply_t *reply);

---

🌈 REQUEST ARGUMENTS 🌈

• conn — the XCB connection to X11. that's it, that's the whole argument list, she's low maintenance 💜

---

⭐ REPLY FIELDS ⭐

• response_type — the type of this reply, which in this case is XCB_XINERAMA_QUERY_SCREENS. this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other. very much "which one of y'all is this" energy 👑
• sequence — the sequence number of the last request the X11 server actually processed. the receipts, basically 🧾
• length — the length of the reply, measured in words. and bestie, a word is 4 bytes. write that down 📝
• number — TODO: NOT YET DOCUMENTED. yeah. nobody wrote it. it's giving mystery, it's giving main character with no backstory 💀

---

💀 DESCRIPTION 💀

nothing here. genuinely empty. the description said "not today" and left 🫶

---

🔥 RETURN VALUE 🔥

so it hands you back an xcb_xinerama_query_screens_cookie_t. the errors? you don't deal with them here, you have to handle them when you call the reply function xcb_xinerama_query_screens_reply.

and if you'd rather catch errors in the event loop instead? use xcb_xinerama_query_screens_unchecked. peek xcb-requests(3) for the whole tea ☕

---

🚫 ERRORS 🚫

This request does never generate any errors. not a single one. flawless behaviour, no notes, she ate and left no crumbs ✨

---

👀 SEE ALSO 👀

(empty, bestie. nothing to see. the see also said see nothing 🎀)

---

🫶 AUTHOR 🫶

Generated from xinerama.xml. if you spot something wrong and want corrections and improvements, hit up xcb@lists.freedesktop.org — they're literally waiting for your email 💌

---

and that's the whole page!! this came from X Version 11, libxcb 1.17.0, and it's the xcb_xinerama_query_screens(3) page — go forth and query those screens, you absolute icon 💖✨🦋