XkbCopyKeyTypes(3)

bestie, welcome to XkbCopyKeyTypes(3) from the XKB FUNCTIONS manual — it's giving “copy more than one XkbKeyTypeRec structure,” and honestly? iconic. 💅✨

🌸 NAME 🌸

XkbCopyKeyTypes — copy more than one XkbKeyTypeRec structure. no cap, that's the whole name.

✨ SYNOPSIS ✨

Status XkbCopyKeyTypes (XkbKeyTypePtr from, XkbKeyTypePtr into, int
       num_types);

🎀 ARGUMENTS 🎀

• from — pointer to array of XkbKeyTypeRecs to copy. literally the source array, bestie.
• into — pointer to array of XkbKeyTypeRecs to change. this is the destination glow-up.
• num_types — number of types to copy. yes, a count. iconic.

💖 DESCRIPTION 💖

So XkbCopyKeyTypes copies num_types XkbKeyTypeRec structures from the array specified by from into the array specified by into. that's the main character move.

Quick vibe check: it is intended for copying between, rather than within, keyboard descriptions, so it doesn't check for overlaps. lowkey important.

The same rules that apply to the from and into parameters in XkbCopyKeyType apply to each entry of the from and into arrays of XkbCopyKeyTypes. iykyk.

If any allocation errors occur while copying from to into, XkbCopyKeyTypes returns BadAlloc. Otherwise, XkbCopyKeyTypes copies from to into and returns Success. periodt.

🔥 RETURN VALUES 🔥

• Success — the XkbCopyKeyTypes function returns Success when there are no allocation errors. she's clear.

🌈 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. that's the allocation-error mood.

🫶 SEE ALSO 🫶

• XkbCopyKeyType(3)

---

💖 cute little sign-off: X Version 11, libX11 1.8.14 — mwah, bestie, you ate this page 💖