xcb_shape_query_version(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_shape_query_version πŸ’…

okay bestie, welcome to the XCB Requests corner of the manual, page xcb_shape_query_version(3). yes the name is long. yes you're gonna say it in one breath. let's go πŸ¦‹


🌸 NAME 🌸

xcb_shape_query_version β€” it asks the X server what version of the SHAPE extension it's running (the NAME section was literally just vibes and a dash, so we're keeping it real)


✨ SYNOPSIS ✨

first things first, you gotta pull in the header, no cap:

#include <xcb/shape.h>

πŸŽ€ Request function

xcb_shape_query_version_cookie_t
       xcb_shape_query_version(xcb_connection_t *conn,

🫢 Reply datastructure

this is the lil struct that comes back at you:

typedef struct xcb_shape_query_version_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint16_t major_version;
    uint16_t minor_version;
} xcb_shape_query_version_reply_t;

πŸ’– Reply function

xcb_shape_query_version_reply_t
       *xcb_shape_query_version_reply(xcb_connection_t *conn,
       xcb_shape_query_version_cookie_t cookie,
       xcb_generic_error_t **e);

πŸ‘‘ REQUEST ARGUMENTS πŸ‘‘

  • conn β€” the XCB connection to X11. that's it. that's the whole argument list. iconic, honestly.

🌈 REPLY FIELDS 🌈

  • response_type β€” the type of this reply, and in this case it's XCB_SHAPE_QUERY_VERSION. this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other when they're all piled up in the group chat.
  • sequence β€” the sequence number of the last request the X11 server processed. like a lil receipt number 🧾
  • length β€” how long the reply is, in words. and no, not vibes words β€” a word here is 4 bytes.
  • major_version β€” TODO: NOT YET DOCUMENTED. (bestie the docs really said "figure it out" 😭)
  • minor_version β€” TODO: NOT YET DOCUMENTED. (same energy, same void πŸ•³οΈ)

πŸ’œ DESCRIPTION πŸ’œ

okay so. the DESCRIPTION section is empty. nothing. a whole blank. not me staring at the void 😭

⭐ RETURN VALUE ⭐

you get back an xcb_shape_query_version_cookie_t πŸͺ β€” a cookie, a promise, a little "your answer is coming, bestie."

errors have to be handled when you call the reply function xcb_shape_query_version_reply.

but if you'd rather handle errors in the event loop instead? use xcb_shape_query_version_unchecked. see xcb-requests(3) for the details, iykyk.


πŸ’€ ERRORS πŸ’€

this request never generates any errors. zero. none. not a single one. it's giving peaceful. ✨


🌟 SEE ALSO 🌟

(the SEE ALSO section was empty too, so there's nothing to point you at β€” go live your life πŸ¦‹)


πŸ™ˆ AUTHOR πŸ™ˆ

generated from shape.xml. contact xcb@lists.freedesktop.org for corrections and improvements β€” fr fr, they want your feedback.


and that's the whole page, bestie 🫢 this one came from X Version 11, libxcb 1.17.0, and it lives at xcb_shape_query_version(3). go query that version, you absolute main character πŸ’…πŸ‘‘