XkbCopyKeyType(3)

💖 NAME 💖

Straight outta XKB FUNCTIONS, bestie: XkbCopyKeyType — copy one XkbKeyTypeRec structures. Yes, “structures,” plural, the manual said what it said 💀.

✨ SYNOPSIS ✨

Status XkbCopyKeyType (XkbKeyTypePtr from, XkbKeyTypePtr into);

That’s the whole vibe: you hand it two XkbKeyTypePtrs and it does the copy. Slay. 💅

🎀 ARGUMENTS 🎀

• from — pointer to XkbKeyTypeRec to be copied.
• into — pointer to XkbKeyTypeRec to be changed.

🦋 DESCRIPTION 🦋

Okay so XkbCopyKeyType copies the key type specified by from to the key type specified by into. Both of them must point to legal XkbKeyTypeRec structures, periodt.

⚠️ Warning: Xkb assumes from and into point to different places. As a result, overlaps can be fatal. Do not let these two overlap, bestie, fr fr 😭.

Before it copies anything, XkbCopyKeyType frees any existing map, preserve, and level_names in into prior to copying. So yes, it clears the old stuff first 💅.

If any allocation errors occur while copying from to into, XkbCopyKeyType returns BadAlloc. Otherwise, XkbCopyKeyType copies from to into and returns Success. Iconic. ✨

🌸 STRUCTURES 🌸

Key types are used to determine the shift level of a key given the current state of the keyboard. The set of all possible key types for the Xkb keyboard description are held in the types field of the client map, whose total size is stored in size_types, and whose total number of valid entries is stored in num_types.

Key types are defined using the following structure:

       typedef struct {                   /* Key Type */
           XkbModsRec        mods;        /* modifiers used to compute shift level */
           unsigned char     num_levels;  /* total # shift levels, do not modify directly */
           unsigned char     map_count;   /* # entries in map, preserve (if non-NULL) */
           XkbKTMapEntryPtr  map;         /* vector of modifiers for each shift level */
           XkbModsPtr        preserve;    /* mods to preserve for corresponding map entry */
           Atom              name;        /* name of key type */
           Atom *            level_names; /* array of names of each shift level */
       } XkbKeyTypeRec, *XkbKeyTypePtr;

💅 DIAGNOSTICS 💅

• BadAlloc — Unable to allocate storage.

---

And that’s the footer credits, bestie: X Version 11 + libX11 1.8.14 💜. No date is listed, so we’re not inventing one 🫶. That’s a wrap, periodt. 🎀