xcb_free_colors(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_free_colors — it's an XCB request from the XCB Requests manual, bestie. The title line says xcb_free_colors(3) and the whole thing lives in libxcb, so you know it's ✨real✨.

🎀 SYNOPSIS 🎀

First things first, you gotta pull in the header:

#include <xcb/xproto.h>

🦋 Request function 🦋

xcb_void_cookie_t xcb_free_colors(xcb_connection_t *conn,
       xcb_colormap_t cmap, uint32_t plane_mask, uint32_t pixels_len,
       const uint32_t *pixels);

Look at that signature. She's giving void cookie, she's giving colormap energy. Periodt.

🌸 REQUEST ARGUMENTS 🌸

  • conn — The XCB connection to X11. Your lil lifeline to the server, no cap.
  • cmap — TODO: NOT YET DOCUMENTED. (Yeah girl, the docs said "we'll get to it" and then… didn't. 😭)
  • plane_mask — TODO: NOT YET DOCUMENTED. The mystery continues.
  • pixels_len — TODO: NOT YET DOCUMENTED. Still a mystery.
  • pixels — TODO: NOT YET DOCUMENTED. Four for four on the mystery front, iconic honestly.

🙈 DESCRIPTION 🙈

So… the description section? It's literally empty. Not a single word. The vibe is silence, the vibe is mystery, the vibe is read the source code iykyk. 🫶

⭐ RETURN VALUE ⭐

She hands you back an xcb_void_cookie_t. Any errors (if there even are any) have to be handled in the event loop, bestie — that's just how it works around here.

But wait — if you'd rather handle errors directly with xcb_request_check instead, use xcb_free_colors_checked. See xcb-requests(3) for all the deets. 👑

💀 ERRORS 💀

Okay so hear me out: this request does never generate any errors. Zero. None. Not a single one. She's flawless, she's unbothered, she's not gonna pop up in your error handling. 💅

🌈 SEE ALSO 🌈

Nothing here. Empty. A lil blank space where the cross-references should be. We move. 🧚

✨ AUTHOR ✨

Generated from xproto.xml. If you spot something that needs fixing or improving, hit up xcb@lists.freedesktop.org — they're taking corrections and improvements, fr fr. 📧

That's the whole page, babe. Short, sweet, and full of TODOs. Not her fault, she's just built different. 💜

Kisses from the XCB manual — this was xcb_free_colors(3), X Version 11, libxcb 1.17.0. Byeee, go free some colors! 🎀🦋💖

📦 where this page comes from