XkbAllocGeomOverlayKeys(3)

💅 XkbAllocGeomOverlayKeys(3) 💅

manual name: XKB FUNCTIONS — we're in the XKB functions section, bestie ✨

🌸 NAME 🌸

XkbAllocGeomOverlayKeys — Allocate keys in an overlay row 👑

🛠️ SYNOPSIS 🛠️

Status XkbAllocGeomOverlayKeys (XkbOverlayRowPtr row, int num_needed);

🎀 ARGUMENTS 🎀

• row — section for which rows should be allocated 🫶
• num_needed — number of new rows required ✨

💖 DESCRIPTION 💖

Okay so Xkb provides a number of functions to allocate and free subcomponents of a keyboard geometry. Use these functions to create or modify keyboard geometries, bestie 🦋.

Big important note: these functions merely allocate space for the new element(s). It is up to you to fill in the values explicitly in your code — yes, you, manually, no cap 🙈.

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 😭). 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.

XkbAllocGeomOverlayKeys allocates num_needed keys and adds them to the row. No initialization of the keys is done — literally none, zero, nada 💀.

🚨 DIAGNOSTICS 🚨

• BadAlloc — Unable to allocate storage 😵‍💫
• BadValue — An argument is out of range 🚫

---

k bye bestie 💖 this page is from X Version 11, libX11 1.8.14 — catch u on the next manpage 🎀🦋✨