XkbFreeGeomKeyAliases(3)

🦋 XkbFreeGeomKeyAliases — from the XKB FUNCTIONS manual 🦋

✨ NAME ✨

XkbFreeGeomKeyAliases — free geometry key aliases. That's it, that's the job, and it ate. 💅

---

🌈 SYNOPSIS 🌈

       void XkbFreeGeomKeyAliases (XkbGeometryPtr geom, int first, int count,
              Bool free_all);

---

🎀 ARGUMENTS 🎀

• geom — the geometry where the key aliases should be freed, bestie.
• first — the first key alias to be freed.
• count — how many key aliases to free.
• free_all — True => all key aliases are freed. Like, all of them, no cap.

---

💖 DESCRIPTION 💖

Okay so Xkb provides a whole crew 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), and it is up to you to fill in the values explicitly in your code. They're giving scaffolding, not finished lewk. ✨

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. So yeah, failure is dramatic like that. 😭

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.

If free_all is True, all aliases in the top level of the specified geometry geom are freed regardless of the value of first or count. Otherwise, count aliases in geom are freed beginning with the one specified by first. So don't come for first and count when free_all is already doing the most. 👑

---

👑 RETURN VALUES 👑

• Success — The XkbFreeGeomKeyAliases function returns Success if there are no allocation errors. Slay. ✅

---

💀 DIAGNOSTICS 💀

• BadAlloc — Unable to allocate storage. Storage said no. 🙈
• BadValue — An argument is out of range. Rude, but valid. 🚩

---

and that's the whole page, bestie 🫶 — brought to you by the footer's X Version 11 / libX11 1.8.14 source/version info and the XkbFreeGeomKeyAliases(3) page name — no separate date printed, so that's the whole footer tea. 🍵🎀