XkbAllocGeomSections(3)

💖 NAME 💖

okay bestie, this page is XkbAllocGeomSections(3), and it lives in the XKB FUNCTIONS manual. It does exactly what it says on the tin: allocates geometry sections. iconic allocation behavior, no cap ✨

🎀 SYNOPSIS 🎀

Status XkbAllocGeomSections (XkbGeometryPtr geom, int num_needed);

🌸 ARGUMENTS 🌸

• geom — the geometry for which sections should be allocated 🫶
• num_needed — the number of new sections required 💅

🦋 DESCRIPTION 🦋

Xkb provides a whole little collection of functions to allocate and free 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) — it is up to you to fill in the values explicitly in your code. They increase sz_* but never touch num_* (unless there is an allocation failure, in which case they reset both sz_* and num_* to zero). These functions return Success if they succeed, BadAlloc if they are not able to allocate space, or BadValue if a parameter is not as expected.

XkbAllocGeomSections allocates num_needed sections and adds them to the geometry geom. No initialization of the sections is done. Like, zero. none. you're on your own to fill them in 😭

To free geometry sections, use XkbFreeGeomSections.

💅 DIAGNOSTICS 💅

• BadAlloc — Unable to allocate storage 😭
• BadValue — An argument is out of range 💀

👑 SEE ALSO 👑

• XkbFreeGeomSections(3)

---

with all my love and absolutely no cap: <rainbow>X Version 11</rainbow>, <pink>libX11 1.8.14</pink>, and this XkbAllocGeomSections(3) page. the footer didn't hand me a date, so no invented date bestie — periodt 💖✨