keymap: add xkb_keymap_key_get_name()

this function is the inverse of xkb_keymap_key_by_name()

Signed-off-by: Mike Blumenkrantz <[email protected]>

src/keymap.c

@@ -470,6 +470,19 @@ xkb_keymap_key_for_each(struct xkb_keymap *keymap, xkb_keymap_key_iter_t iter,
         iter(keymap, key->keycode, data);
 }
 
+XKB_EXPORT const char *
+xkb_keymap_key_get_name(struct xkb_keymap *keymap, xkb_keycode_t kc)
+{
+    struct xkb_key *key;
+
+    xkb_keys_foreach(key, keymap) {
+        if (key->keycode == kc)
+            return xkb_atom_text(keymap->ctx, key->name);
+    }
+
+    return NULL;
+}
+
 XKB_EXPORT xkb_keycode_t
 xkb_keymap_key_by_name(struct xkb_keymap *keymap, const char *keyname)
 {

xkbcommon/xkbcommon.h

@@ -940,6 +940,19 @@ void
 xkb_keymap_key_for_each(struct xkb_keymap *keymap, xkb_keymap_key_iter_t iter,
                         void *data);
 
+/**
+ * Find the key name for a given keycode in a keymap.
+ *
+ * @returns The key name. If no key with this keycode exists,
+ * returns NULL.
+ *
+ * @sa xkb_keycode_t
+ * @memberof xkb_keymap
+ * @since 0.6.0
+ */
+const char *
+xkb_keymap_key_get_name(struct xkb_keymap *keymap, xkb_keycode_t kc);
+
 /**
  * Find the keycode for a given keyname in a keymap.
  *