XkbFreeGeomRows(3)

📦
version 1.8.14 · 8 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

okay bestie, this is XkbFreeGeomRows(3) from the XKB FUNCTIONS manual — the page where we free rows in a section and try to keep our keyboard geometry life together. 💅✨

💖 NAME 💖

XkbFreeGeomRows — free rows in a section. That's the name, that's the job, and it's lowkey iconic. 👑

✨ SYNOPSIS ✨

void XkbFreeGeomRows (XkbSectionPtr section, int first, int count, Bool free_all);

🎀 ARGUMENTS 🎀

  • section — the section in which rows should be freed. This is the location of the whole cleanup era. 📍
  • first — the first row to be freed. Gotta start somewhere, bestie. 🥇
  • count — the number of rows to be freed. Math, but make it slay. 🔢
  • free_all — when this is True, all rows are freed (True => all rows are freed). It's the "free everyone" button. 💯

🌸 DESCRIPTION 🌸

okay so Xkb has a whole bunch of functions for allocating and freeing subcomponents of a keyboard geometry. You use these functions to create or modify keyboard geometries. But here's the important tea: 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 do not auto-fill the values 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. 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. 🫶

Now for XkbFreeGeomRows itself: if free_all is True, all rows are freed regardless of the value of first and count. Otherwise, the number of rows specified by count are freed, beginning with the row specified by first in the specified section. Selective cleanup or full send, your call. 😭🔥

🔥 RETURN VALUES 🔥

  • Success — XkbFreeGeomRows returns Success when there are no allocation or argument errors. Queen behavior, no notes. 👑

💀 DIAGNOSTICS 💀

  • BadAlloc — Unable to allocate storage. The storage said no, and honestly same. 😭
  • BadValue — An argument is out of range. It's giving "not like the other arguments." 🙈

byeee 🫶 this page is signed off with X Version 11, libX11 1.8.14, and the XkbFreeGeomRows(3) footer tag — the original footer line doesn't list a separate date, so that's the source/version/date tea, no cap. 💖🎀

📦 where this page comes from