XkbAllocGeomOverlayRows(3)

okay bestie, this is XkbAllocGeomOverlayRows(3) from the XKB FUNCTIONS manual — and we are allocating rows in a overlay today 💅✨

✨ NAME ✨

XkbAllocGeomOverlayRows — allocate rows in a overlay 🎀

💅 SYNOPSIS 💅

Status XkbAllocGeomOverlayRows (XkbOverlayPtr overlay, int num_needed);

🫶 ARGUMENTS 🫶

• overlay — the section you're allocating rows for, bestie 🦋
• num_needed — how many new rows you need, required count, no cap 🌸

🌈 DESCRIPTION 🌈

Xkb ships a whole little crew of functions for allocating and freeing subcomponents of a keyboard geometry. Use these functions to create or modify keyboard geometries. 🧚

⚠️ important vibe check: these functions merely allocate space for the new element(s), and it is up to you to fill in the values explicitly in your code. They will not do the fill-in for you, periodt.

These allocation functions increase sz_* but never touch num_* — unless there is an allocation failure, in which case they reset both sz_* and num_* to zero. 😭

The general allocation crew returns Success if they succeed, BadAlloc if they are not able to allocate space, or BadValue if a parameter is not as expected. 💖

XkbAllocGeomOverlayRows allocates num_needed rows and adds them to the overlay. No initialization of the rows is done. Like, none. Zero. Nada. 🙈

To free rows in an overlay, use XkbFreeGeomOverlayRows. 🎀

🚩 DIAGNOSTICS 🚩

• BadAlloc — unable to allocate storage 😭
• BadValue — an argument is out of range 🚩

👑 SEE ALSO 👑

XkbFreeGeomOverlayRows(3)

---

that's the cute lil sign-off from the footer: X Version 11, libX11 1.8.14, and XkbAllocGeomOverlayRows(3) — periodt 💖🎀