ARK-OS/arkos/arkrt/libxkbcommon/test/keysym.c

/*
 * Copyright © 2009 Dan Nicholson
 * SPDX-License-Identifier: MIT
 */
#include "config.h"
#include "test-config.h"

#include <assert.h>
#include <locale.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>

#if HAVE_ICU
#include <unicode/uchar.h>
#include <unicode/ustring.h>
#include <unicode/utf16.h>
#include "test/keysym-case-mapping.h"
#endif

#include "xkbcommon/xkbcommon-keysyms.h"
#include "xkbcommon/xkbcommon.h"
#include "src/keysym.h" /* For unexported is_lower/upper/keypad() */
#include "test.h"
#include "test/keysym.h"
#include "utils.h"
#include "utils-numbers.h"

/* Explicit ordered list of modifier keysyms */
static const xkb_keysym_t modifier_keysyms[] = {
    XKB_KEY_ISO_Lock,
    XKB_KEY_ISO_Level2_Latch,
    XKB_KEY_ISO_Level3_Shift,
    XKB_KEY_ISO_Level3_Latch,
    XKB_KEY_ISO_Level3_Lock,
    /* XKB_KEY_ISO_Group_Shift == XKB_KEY_Mode_switch */
    XKB_KEY_ISO_Group_Latch,
    XKB_KEY_ISO_Group_Lock,
    XKB_KEY_ISO_Next_Group,
    XKB_KEY_ISO_Next_Group_Lock,
    XKB_KEY_ISO_Prev_Group,
    XKB_KEY_ISO_Prev_Group_Lock,
    XKB_KEY_ISO_First_Group,
    XKB_KEY_ISO_First_Group_Lock,
    XKB_KEY_ISO_Last_Group,
    XKB_KEY_ISO_Last_Group_Lock,
    0xfe10, /* Currently unassigned, but xkb_keysym_is_modifier returns true */
    XKB_KEY_ISO_Level5_Shift,
    XKB_KEY_ISO_Level5_Latch,
    XKB_KEY_ISO_Level5_Lock,

    XKB_KEY_Mode_switch,
    XKB_KEY_Num_Lock,

    XKB_KEY_Shift_L,
    XKB_KEY_Shift_R,
    XKB_KEY_Control_L,
    XKB_KEY_Control_R,
    XKB_KEY_Caps_Lock,
    XKB_KEY_Shift_Lock,

    XKB_KEY_Meta_L,
    XKB_KEY_Meta_R,
    XKB_KEY_Alt_L,
    XKB_KEY_Alt_R,
    XKB_KEY_Super_L,
    XKB_KEY_Super_R,
    XKB_KEY_Hyper_L,
    XKB_KEY_Hyper_R
};

#define MIN_MODIFIER_KEYSYM modifier_keysyms[0]
#define MAX_MODIFIER_KEYSYM modifier_keysyms[ARRAY_SIZE(modifier_keysyms) - 1]

static void
test_modifiers_table(void)
{
    xkb_keysym_t ks = XKB_KEY_NoSymbol;

    /* Ensure ordered array */
    for (size_t k = 0; k < ARRAY_SIZE(modifier_keysyms); k++) {
        assert_printf(ks < modifier_keysyms[k],
                      "modifier_keysyms[] is not ordered: 0x%04"PRIx32">=0x%04"PRIx32"\n",
                      ks, modifier_keysyms[k]);
        ks = modifier_keysyms[k];
    }

    /* Unassigned keysym */
    assert(!xkb_keysym_is_assigned(0xfe10));
}

static bool
test_modifier(xkb_keysym_t ks)
{
    if (ks < MIN_MODIFIER_KEYSYM || ks > MAX_MODIFIER_KEYSYM)
        return false;
    for (size_t k = 0; k < ARRAY_SIZE(modifier_keysyms); k++) {
        if (ks == modifier_keysyms[k])
            return true;
    }
    return false;
}

static bool
test_keypad(xkb_keysym_t ks, char *name)
{
    const char prefix[] = "KP_";
    return strncmp(prefix, name, sizeof(prefix) - 1) == 0;
}

static int
test_string(const char *string, xkb_keysym_t expected)
{
    xkb_keysym_t keysym;

    keysym = xkb_keysym_from_name(string, XKB_KEYSYM_NO_FLAGS);

    fprintf(stderr, "Expected string %s -> 0x%"PRIx32"\n", string, expected);
    fprintf(stderr, "Received string %s -> 0x%"PRIx32"\n\n", string, keysym);

    return keysym == expected;
}

static int
test_casestring(const char *string, xkb_keysym_t expected)
{
    xkb_keysym_t keysym;

    keysym = xkb_keysym_from_name(string, XKB_KEYSYM_CASE_INSENSITIVE);

    fprintf(stderr, "Expected casestring %s -> 0x%"PRIx32"\n", string, expected);
    fprintf(stderr, "Received casestring %s -> 0x%"PRIx32"\n\n", string, keysym);

    return keysym == expected;
}

static void
test_ambiguous_icase_names(const struct ambiguous_icase_ks_names_entry *entry)
{
    for (int k = 0; k < entry->count; k++) {
        /* Check expected result */
        assert(test_casestring(entry->names[k], entry->keysym));
        /* If the keysym is cased, then check the resulting keysym is lower-cased */
        xkb_keysym_t keysym = xkb_keysym_from_name(entry->names[k], 0);
        if (xkb_keysym_is_lower(keysym) || xkb_keysym_is_upper_or_title(keysym)) {
            assert(xkb_keysym_is_lower(entry->keysym));
        }
    }
}

static int
test_keysym(xkb_keysym_t keysym, const char *expected)
{
    char s[XKB_KEYSYM_NAME_MAX_SIZE];

    xkb_keysym_get_name(keysym, s, sizeof(s));

    fprintf(stderr, "Expected keysym %#06"PRIx32" -> %s\n", keysym, expected);
    fprintf(stderr, "Received keysym %#06"PRIx32" -> %s\n\n", keysym, s);

    return streq(s, expected);
}

static bool
test_deprecated(xkb_keysym_t keysym, const char *name,
                bool expected_deprecated, const char *expected_reference)
{
    const char *reference;
    bool deprecated = xkb_keysym_is_deprecated(keysym, name, &reference);

    fprintf(stderr, "Expected keysym %#06"PRIx32" -> deprecated: %d, reference: %s\n",
            keysym, expected_deprecated, expected_reference);
    fprintf(stderr, "Received keysym %#06"PRIx32" -> deprecated: %d, reference: %s\n",
            keysym, deprecated, reference);

    return deprecated == expected_deprecated &&
           (
            (reference == NULL && expected_reference == NULL) ||
            (reference != NULL && expected_reference != NULL &&
             strcmp(reference, expected_reference) == 0)
           );
}

static int
test_utf8(xkb_keysym_t keysym, const char *expected)
{
    char s[XKB_KEYSYM_UTF8_MAX_SIZE];

    const int ret = xkb_keysym_to_utf8(keysym, s, sizeof(s));
    if (ret <= 0 || !expected)
        return (!ret && !expected);

    fprintf(stderr, "Expected keysym %#06"PRIx32" -> %s (%zu bytes)\n", keysym, expected,
            strlen(expected));
    fprintf(stderr, "Received keysym %#06"PRIx32" -> %s (%zu bytes)\n\n", keysym, s,
            strlen(s));

    return streq(s, expected);
}

#if HAVE_ICU

static UVersionInfo xkb_unicode_version = XKB_KEYSYM_UNICODE_VERSION;
static UVersionInfo icu_unicode_version;

static inline int
compare_unicode_version(const UVersionInfo v1, const UVersionInfo v2)
{
    return memcmp(v1,v2,sizeof(UVersionInfo));
}

/* Unicode assertion
 * In case the test fails, do not raise an exception if there is
 * an ICU version mismatch with our Unicode version. */
#define uassert_printf(cp, cond, ...)                                                     \
   if (!(cond)) {                                                                         \
      fprintf(stderr, "Assertion failure: " __VA_ARGS__);                                 \
      UVersionInfo char_age;                                                              \
      u_charAge((UChar32)cp, char_age);                                                   \
      if (compare_unicode_version(char_age, xkb_unicode_version) > 0) {                   \
        fprintf(stderr,                                                                   \
                "[WARNING] ICU version mismatch: "                                        \
                "too recent for code point: "CODE_POINT"\n", cp);                         \
      } else if (compare_unicode_version(icu_unicode_version, xkb_unicode_version) < 0) { \
        fprintf(stderr,                                                                   \
                "[WARNING] ICU version mismatch: "                                        \
                "too old for code point: "CODE_POINT"\n", cp);                            \
      } else {                                                                            \
        assert(cond);                                                                     \
      }                                                                                   \
   }

#define KEYSYM     "0x%04"PRIx32
#define CODE_POINT "U+%04"PRIX32

static void
test_icu_case_mappings(xkb_keysym_t ks)
{
    uint32_t cp = xkb_keysym_to_utf32(ks);

    /* Check predicates */
    bool is_lower = xkb_keysym_is_lower(ks);
    uint32_t expected = !!u_isULowercase((UChar32) cp);
    uassert_printf(cp, is_lower == expected,
                   "Invalid xkb_keysym_is_lower("KEYSYM") ("CODE_POINT"): "
                   "expected %d, got: %d\n",
                   ks, cp, expected, is_lower);
    bool is_upper_or_title = xkb_keysym_is_upper_or_title(ks);
    expected = !!(u_isUUppercase((UChar32) cp) || u_istitle((UChar32) cp));
    uassert_printf(cp, is_upper_or_title == expected,
                   "Invalid xkb_keysym_is_upper_or_title("KEYSYM") ("CODE_POINT"): "
                   "expected %d, got: %d\n",
                   ks, cp, expected, is_upper_or_title);
    assert(is_lower != is_upper_or_title || !is_lower);

    /* Check lower case mapping */
    xkb_keysym_t ks_mapped = xkb_keysym_to_lower(ks);
    expected = to_simple_lower(cp);
    if (u_istitle((UChar32) cp)) {
        /* Check that title case letter have simple lower case mappings */
        uassert_printf(cp, ks_mapped != ks && expected != cp,
                       "Invalid title case lower transformation. "
                       "Expected keysym: "KEYSYM" != "KEYSYM" "
                       "and code point "CODE_POINT" != "CODE_POINT"\n",
                       ks_mapped, ks, expected, cp);
    }
    if (ks_mapped && ks_mapped != ks) {
        /* Given keysym has been transformed to lower-case */
        uint32_t cp_mapped = xkb_keysym_to_utf32(ks_mapped);
        uint32_t got = cp_mapped;
        uassert_printf(cp, got == expected,
                       "Invalid xkb_keysym_to_lower("KEYSYM") == "KEYSYM": "
                       "expected "CODE_POINT", got: "CODE_POINT"\n",
                       ks, ks_mapped, expected, got);
        uassert_printf(cp, is_upper_or_title,
                       "Expected upper case for keysym "KEYSYM" ("CODE_POINT")\n",
                       ks, cp);
        got = !!xkb_keysym_is_lower(ks_mapped);
        expected = !!u_isULowercase((UChar32) cp_mapped);
        uassert_printf(cp_mapped, got == expected,
                       "Invalid xkb_keysym_is_lower("KEYSYM") ("CODE_POINT"): "
                       "expected %d, got: %d (tested keysym: "KEYSYM")\n",
                       ks_mapped, cp_mapped, expected, got, ks);
    } else if (expected != cp) {
        /* Missing case mapping; the corresponding predicate must be consistent. */
        fprintf(stderr,
                "[WARNING] Missing lower case mapping for "KEYSYM": "
                "expected "CODE_POINT", got: "CODE_POINT"\n",
                ks, expected, cp);
        uassert_printf(cp, !xkb_keysym_is_upper_or_title(ks),
                       "Invalid xkb_keysym_is_upper_or_title("KEYSYM") ("CODE_POINT"): "
                       "expected false, got: true\n",
                       ks, cp);
    }

    /* Check upper case mapping */
    ks_mapped = xkb_keysym_to_upper(ks);
    expected = to_simple_upper(cp);
    if (u_istitle((UChar32) cp)) {
        /* Check title case upper mapping; may be:
         * • simple: 1 code point, or
         * • special: muliple code points */
        UChar cp_string[2] = {0};
        UChar cp_expected_string[8] = {0};
        UBool isError = false;
        int32_t offset = 0;
        /* Convert code point to UTF-16 string */
        U16_APPEND(cp_string, offset, (int32_t) ARRAY_SIZE(cp_string), cp, isError);
        UErrorCode pErrorCode = U_ZERO_ERROR;
        /* Unicode full upper mapping */
        int32_t length = u_strToUpper(cp_expected_string,
                                      ARRAY_SIZE(cp_expected_string),
                                      cp_string, offset, "C", &pErrorCode);
        length = u_countChar32(cp_expected_string, length);
        if (length == 1) {
            /* Simple upper case mapping: one-to-one. */
            uint32_t cp_mapped = xkb_keysym_to_utf32(ks_mapped);
            uassert_printf(cp,
                           !isError && pErrorCode == U_ZERO_ERROR &&
                           ks_mapped != ks && expected != cp &&
                           u_isUUppercase(cp_mapped),
                           "Invalid title case simple upper transformation. "
                           "Expected keysym: "KEYSYM" != "KEYSYM" "
                           "and code point "CODE_POINT" != "CODE_POINT"\n",
                           ks_mapped, ks, expected, cp);
        } else {
            /* Special upper case mapping: maps to multiple code points.
             * We do not handle those, so our mapping is the original. */
            uassert_printf(cp,
                           !isError && pErrorCode == U_ZERO_ERROR &&
                           ks_mapped == ks && expected == cp && length > 1,
                           "Invalid title case special upper transformation. "
                           "Expected keysym: "KEYSYM" == "KEYSYM" "
                           "and code point "CODE_POINT" == "CODE_POINT"\n",
                           ks_mapped, ks, expected, cp);
        }
    }
    if (ks_mapped && ks_mapped != ks) {
        /* Given keysym has been transformed to upper-case */
        uint32_t cp_mapped = xkb_keysym_to_utf32(ks_mapped);
        uint32_t got = cp_mapped;
        uassert_printf(cp, got == expected,
                       "Invalid xkb_keysym_to_upper("KEYSYM") == "KEYSYM": "
                       "expected "CODE_POINT", got: "CODE_POINT"\n",
                       ks, ks_mapped, expected, got);
        uassert_printf(cp, is_lower || u_istitle(cp),
                       "Expected lower or title case for keysym "KEYSYM" ("CODE_POINT")\n",
                       ks, cp);
        got = !!xkb_keysym_is_upper_or_title(ks_mapped);
        expected = !!(u_isUUppercase((UChar32)cp_mapped) || u_istitle((UChar32)cp_mapped));
        uassert_printf(cp_mapped, got == expected,
                       "Invalid xkb_keysym_is_upper_or_title("KEYSYM") ("CODE_POINT"): "
                       "expected %d, got: %d (tested keysym: "KEYSYM")\n",
                       ks_mapped, cp_mapped, expected, got, ks);
    } else if (expected != cp) {
        /* Missing case mapping; the corresponding predicate must be consistent. */
        fprintf(stderr,
                "[WARNING] Missing upper case mapping for "KEYSYM": "
                "expected "CODE_POINT", got: "CODE_POINT"\n",
                ks, expected, cp);
        uassert_printf(cp, !xkb_keysym_is_lower(ks),
                       "Invalid xkb_keysym_is_lower("KEYSYM") ("CODE_POINT"): "
                       "expected false, got: true\n",
                       ks, cp);
    }
}
#endif

static void
test_github_issue_42(void)
{
    // Verify we are not dependent on locale, Turkish-i problem in particular.
    if (setlocale(LC_CTYPE, "tr_TR.UTF-8") == NULL) {
        // The locale is not available, probably; skip.
        return;
    }

    assert(test_string("i", XKB_KEY_i));
    assert(test_string("I", XKB_KEY_I));
    assert(test_casestring("i", XKB_KEY_i));
    assert(test_casestring("I", XKB_KEY_i));
    assert(xkb_keysym_to_upper(XKB_KEY_i) == XKB_KEY_I);
    assert(xkb_keysym_to_lower(XKB_KEY_I) == XKB_KEY_i);

    setlocale(LC_CTYPE, "C");
}

static void
get_keysym_name(xkb_keysym_t keysym, char *buffer, size_t size)
{
    int name_length = xkb_keysym_get_name(keysym, buffer, size);
    if (name_length < 0) {
        snprintf(buffer, size, "(unknown: %#06"PRIx32")", keysym);
    }
}

static int
test_utf32_to_keysym(uint32_t ucs, xkb_keysym_t expected)
{
    char expected_name[XKB_KEYSYM_NAME_MAX_SIZE];
    char actual_name[XKB_KEYSYM_NAME_MAX_SIZE];
    xkb_keysym_t actual = xkb_utf32_to_keysym(ucs);
    get_keysym_name(expected, expected_name, XKB_KEYSYM_NAME_MAX_SIZE);
    get_keysym_name(actual, actual_name, XKB_KEYSYM_NAME_MAX_SIZE);

    fprintf(stderr, "Code point %#"PRIx32": expected keysym: %s, actual: %s\n\n",
            ucs, expected_name, actual_name);
    return expected == actual;
}

int
main(void)
{
    test_init();

#if HAVE_ICU
    u_getUnicodeVersion(icu_unicode_version);
#endif

    /* Bounds */
    static_assert(XKB_KEYSYM_MIN == 0, "");
    static_assert(XKB_KEYSYM_MIN < XKB_KEYSYM_MAX, "");
    static_assert(XKB_KEYSYM_MAX <= UINT32_MAX, ""); /* Ensure it fits in xkb_keysym_t */
    static_assert(XKB_KEYSYM_MAX <= INT32_MAX, ""); /* Ensure correct cast to int32_t */
    static_assert(XKB_KEYSYM_MIN_ASSIGNED == XKB_KEYSYM_MIN, "");
    static_assert(XKB_KEYSYM_MIN_ASSIGNED < XKB_KEYSYM_MAX_ASSIGNED, "");
    static_assert(XKB_KEYSYM_MAX_ASSIGNED <= XKB_KEYSYM_MAX, "");
    static_assert(XKB_KEYSYM_MIN_EXPLICIT == XKB_KEYSYM_MIN_ASSIGNED, "");
    static_assert(XKB_KEYSYM_MIN_EXPLICIT < XKB_KEYSYM_MAX_EXPLICIT, "");
    static_assert(XKB_KEYSYM_MAX_EXPLICIT <= XKB_KEYSYM_MAX_ASSIGNED, "");
    static_assert(XKB_KEYSYM_COUNT_EXPLICIT <=
                  XKB_KEYSYM_MAX_EXPLICIT - XKB_KEYSYM_MIN_EXPLICIT + 1, "");
    static_assert(XKB_KEYSYM_UNICODE_MIN >= XKB_KEYSYM_MIN_EXPLICIT, "");
    static_assert(XKB_KEYSYM_UNICODE_MIN < XKB_KEYSYM_UNICODE_MAX, "");
    static_assert(XKB_KEYSYM_UNICODE_MAX <= XKB_KEYSYM_MAX_EXPLICIT, "");

    /* Assigned keysyms */
    assert(xkb_keysym_is_assigned(XKB_KEYSYM_MIN));
    assert(xkb_keysym_is_assigned(XKB_KEYSYM_MIN_ASSIGNED));
    assert(xkb_keysym_is_assigned(XKB_KEY_space));
    assert(xkb_keysym_is_assigned(XKB_KEY_nobreakspace));
    assert(xkb_keysym_is_assigned(XKB_KEY_Aogonek));
    assert(xkb_keysym_is_assigned(XKB_KEY_Hstroke));
    assert(xkb_keysym_is_assigned(XKB_KEY_kra));
    assert(xkb_keysym_is_assigned(XKB_KEY_braille_dot_1));
    assert(xkb_keysym_is_assigned(XKB_KEY_XF86KbdLcdMenu5));
    assert(xkb_keysym_is_assigned(XKB_KEY_Shift_L));
    assert(xkb_keysym_is_assigned(XKB_KEY_XF86MonBrightnessUp));
    assert(xkb_keysym_is_assigned(XKB_KEY_VoidSymbol));
    assert(xkb_keysym_is_assigned(XKB_KEYSYM_UNICODE_MIN));
    assert(xkb_keysym_is_assigned((XKB_KEYSYM_UNICODE_MIN + XKB_KEYSYM_UNICODE_MAX) / 2));
    assert(xkb_keysym_is_assigned(XKB_KEYSYM_UNICODE_MAX));
    assert(xkb_keysym_is_assigned(XKB_KEYSYM_MAX_ASSIGNED));
    assert(!xkb_keysym_is_assigned(XKB_KEYSYM_MAX));

    test_modifiers_table();

    /* Reject invalid flags */
    assert(xkb_keysym_from_name("a", -1) == XKB_KEY_NoSymbol);
    assert(xkb_keysym_from_name("a", 0xffff) == XKB_KEY_NoSymbol);

    /* Check xkb_keysym_get_explicit_names works */
    const char* aliases[XKB_KEYSYM_EXPLICIT_ALIASES_MAX] = {0};
    int aliases_count =
        xkb_keysym_get_explicit_names(XKB_KEY_a,
                                      aliases, ARRAY_SIZE(aliases));
    assert(aliases_count == 1);
    assert_streq_not_null("", "a", aliases[0]);

    aliases_count =
        xkb_keysym_get_explicit_names(XKB_KEY_ISO_Group_Shift,
                                      aliases, ARRAY_SIZE(aliases));
    assert(aliases_count == XKB_KEYSYM_EXPLICIT_ALIASES_MAX);
    assert_streq_not_null("", "ISO_Group_Shift", aliases[0]);
    assert_streq_not_null("", "Arabic_switch", aliases[1]);
    assert_streq_not_null("", "Greek_switch", aliases[2]);
    assert_streq_not_null("", "Hangul_switch", aliases[3]);
    assert_streq_not_null("", "Hebrew_switch", aliases[4]);
    assert_streq_not_null("", "kana_switch", aliases[5]);
    assert_streq_not_null("", "Mode_switch", aliases[6]);
    assert_streq_not_null("", "script_switch", aliases[7]);
    assert_streq_not_null("", "SunAltGraph", aliases[8]);

    struct xkb_keysym_iterator *iter = xkb_keysym_iterator_new(false);
    xkb_keysym_t ks_prev = XKB_KEYSYM_MIN;
    uint32_t count = 0;
    uint32_t count_non_unicode = 0;
    while (xkb_keysym_iterator_next(iter)) {
        count++;
        xkb_keysym_t ks = xkb_keysym_iterator_get_keysym(iter);
        if (ks < XKB_KEYSYM_UNICODE_MIN || ks > XKB_KEYSYM_UNICODE_MAX) {
            count_non_unicode++;
        } else {
            const uint32_t cp = ks - XKB_KEYSYM_UNICODE_OFFSET;
            assert(cp);
            const xkb_keysym_t ks2 = xkb_utf32_to_keysym(cp);
            const char *ref;
            assert_printf(!xkb_keysym_is_deprecated(ks2, NULL, &ref),
                          "Unexpected deprecated keysym 0x%04"PRIx32" "
                          "corresponding to code point U+%04"PRIX32"\n",
                          ks2, cp);
            const uint32_t cp2 = xkb_keysym_to_utf32(ks2);
            assert_printf((ks2 == XKB_KEY_NoSymbol && cp2 == 0) ^
                          (ks2 != XKB_KEY_NoSymbol && cp2 == cp),
                          "Unexpected U+%04"PRIX32" != U+%04"PRIX32" "
                          "for keysym 0x%04"PRIx32"\n",
                          cp2, cp, ks2);
        }
        assert(ks > ks_prev || count == 1);
        ks_prev = ks;
        /* Check assigned keysyms bounds */
        assert((int32_t)XKB_KEYSYM_MIN_ASSIGNED <= (int32_t)ks && ks <= XKB_KEYSYM_MAX_ASSIGNED);
        /* Check that we do not convert UTF-32 into a deprecated keysyms */
        const char *ref = NULL;
        if (xkb_keysym_is_deprecated(ks, NULL, &ref)) {
            const uint32_t cp = xkb_keysym_to_utf32(ks);
            if (cp != 0) {
                assert_printf(xkb_utf32_to_keysym(cp) != ks,
                              "Unexpected xkb_utf32_to_keysym(0x%04"PRIX32") == 0x%04"PRIx32"\n",
                              cp, ks);
            }
        }
        /* Check utf8 */
        /* Older implementation required 7 bytes for old UTF-8 (see RFC 2279) */
        char utf8[7];
        int needed = xkb_keysym_to_utf8(ks, utf8, sizeof(utf8));
        assert(0 <= needed && needed <= XKB_KEYSYM_UTF8_MAX_SIZE);
        if (needed) {
            /* UTF-8 Roundtrip */
            const xkb_keysym_t ks_from_utf8 =
                xkb_utf8_to_keysym(utf8, (size_t)needed - 1);
            if (ks_from_utf8 != ks) {
                /* Non canonical mapping */
                const uint32_t expected = xkb_keysym_to_utf32(ks);
                const uint32_t got = xkb_keysym_to_utf32(ks_from_utf8);
                assert_eq("UTF-8 roundtrip for 0x%04"PRIx32,
                        expected, got, "0x%04"PRIx32, ks);
            }
        }
        /* Check maximum name length (`needed` does not include the ending NULL) */
        char name[XKB_KEYSYM_NAME_MAX_SIZE];
        needed = xkb_keysym_iterator_get_name(iter, name, sizeof(name));
        assert(0 < needed && (size_t)needed <= sizeof(name) - 1);
        /* Test modifier keysyms */
        bool expected = test_modifier(ks);
        bool got = xkb_keysym_is_modifier(ks);
        assert_printf(got == expected,
                      "xkb_keysym_is_modifier(0x%04"PRIx32"): expected %d, got: %d\n",
                      ks, expected, got);
        /* Test keypad keysyms */
        expected = test_keypad(ks, name);
        got = xkb_keysym_is_keypad(ks);
        assert_printf(got == expected,
                      "xkb_keysym_is_keypad(0x%04"PRIx32") \"%s\": "
                      "expected %d, got: %d\n",
                      ks, name, expected, got);
        /* Ensure no explicit name would clash with the Unicode notation */
        if (xkb_keysym_iterator_is_explicitly_named(iter)) {
            const int n = xkb_keysym_get_explicit_names(ks, aliases,
                                                        ARRAY_SIZE(aliases));
            assert(n > 0);
            for (int k = 0; k < n; k++) {
                const char* const alias = aliases[k];
                if (alias[0] != 'U')
                    continue;
                uint32_t cp = 0;
                const int r = parse_hex_to_uint32_t(name + 1, SIZE_MAX, &cp);
                /* Either none or incomplete parsing */
                assert((r == 0) ^ (r > 0 && name[r + 1] != '\0'));
            }
        }

#if HAVE_ICU
        /* Check case mappings */
        test_icu_case_mappings(ks);
#endif
    }
    xkb_keysym_iterator_unref(iter);
    assert(ks_prev == XKB_KEYSYM_MAX_ASSIGNED);
    assert(count == XKB_KEYSYM_UNICODE_MAX - XKB_KEYSYM_UNICODE_MIN + 1 + count_non_unicode);

    /* Named keysyms */
    assert(test_string("NoSymbol", XKB_KEY_NoSymbol));
    assert(test_string("Undo", 0xFF65));
    assert(test_string("UNDO", XKB_KEY_NoSymbol)); /* Require XKB_KEYSYM_CASE_INSENSITIVE */
    assert(test_string("ThisKeyShouldNotExist", XKB_KEY_NoSymbol));
    assert(test_string("XF86_Switch_VT_5", 0x1008FE05));
    assert(test_string("VoidSymbol", 0xFFFFFF));
    assert(test_string("0", 0x30));
    assert(test_string("9", 0x39));
    assert(test_string("a", 0x61));
    assert(test_string("A", 0x41));
    assert(test_string("ch", 0xfea0));
    assert(test_string("Ch", 0xfea1));
    assert(test_string("CH", 0xfea2));
    assert(test_string("THORN", 0x00de));
    assert(test_string("Thorn", 0x00de));
    assert(test_string("thorn", 0x00fe));
    assert(test_string(" thorn", XKB_KEY_NoSymbol));
    assert(test_string("thorn ", XKB_KEY_NoSymbol));
#define LONGEST_NAME STRINGIFY2(XKB_KEYSYM_LONGEST_NAME)
#define XKB_KEY_LONGEST_NAME CONCAT2(XKB_KEY_, XKB_KEYSYM_LONGEST_NAME)
    assert(test_string(LONGEST_NAME, XKB_KEY_LONGEST_NAME));
#define LONGEST_CANONICAL_NAME STRINGIFY2(XKB_KEYSYM_LONGEST_CANONICAL_NAME)
#define XKB_KEY_LONGEST_CANONICAL_NAME CONCAT2(XKB_KEY_, XKB_KEYSYM_LONGEST_CANONICAL_NAME)
    assert(test_string(LONGEST_CANONICAL_NAME, XKB_KEY_LONGEST_CANONICAL_NAME));

    /* Non-canonical */
    assert(test_string("dead_small_schwa", XKB_KEY_dead_schwa));
    assert(test_string("dead_schwa", XKB_KEY_dead_schwa));
    assert(test_string("dead_capital_schwa", XKB_KEY_dead_SCHWA));
    assert(test_string("dead_SCHWA", XKB_KEY_dead_SCHWA));

    /* Decimal keysyms are not supported (digits are special cases) */
    assert(test_string("-1", XKB_KEY_NoSymbol));
    assert(test_string("10", XKB_KEY_NoSymbol));
    assert(test_string("010", XKB_KEY_NoSymbol));
    assert(test_string("4567", XKB_KEY_NoSymbol));

    /* Unicode: test various ranges */
    assert(test_string("U0000", XKB_KEY_NoSymbol)); /* Min Unicode, first ASCII ctrl */
    assert(test_string("U0001", 0x01000001)); /* ASCII ctrl without named keysym */
    assert(test_string("U000A", 0x0000ff0a)); /* ASCII ctrl mapping to function keysym */
    assert(test_string("U001F", 0x0100001f)); /* Last ASCII ctrl before first printable */
    assert(test_string("U0020", 0x00000020)); /* First ASCII printable */
    assert(test_string("U007E", 0x0000007e));
    assert(test_string("U007F", 0x0000ffff)); /* Last ASCII code point */
    assert(test_string("U0080", 0x01000080)); /* First non-ASCII code point */
    assert(test_string("U009F", 0x0100009f));
    assert(test_string("U00A0", 0x000000a0));
    assert(test_string("U00FF", 0x000000ff)); /* Last Latin-1 code point */
    assert(test_string("U0100", 0x01000100));
    assert(test_string("U4567", 0x01004567));
    assert(test_string("UD7FF", 0x0100d7ff));
    assert(test_string("UD800", 0x0100d800)); /* Surrogates */
    assert(test_string("UDFFF", 0x0100dfff)); /* Surrogates */
    assert(test_string("UE000", 0x0100e000));
    assert(test_string("UFDCF", 0x0100fdcf));
    assert(test_string("UFDD0", 0x0100fdd0)); /* Noncharacter */
    assert(test_string("UFDEF", 0x0100fdef)); /* Noncharacter */
    assert(test_string("UFDF0", 0x0100fdf0));
    assert(test_string("UFFFD", 0x0100fffd));
    assert(test_string("UFFFE", 0x0100fffe)); /* Noncharacter */
    assert(test_string("UFFFF", 0x0100ffff)); /* Noncharacter */
    assert(test_string("U10000", 0x01010000));
    assert(test_string("U1F4A9", 0x0101F4A9));
    assert(test_string("U10FFFF", XKB_KEYSYM_UNICODE_MAX)); /* Max Unicode */
    assert(test_string("U110000", XKB_KEY_NoSymbol));
    /* Unicode: test syntax */
    assert(test_string("U00004567", 0x01004567));        /* OK:  8 digits */
    assert(test_string("U000004567", XKB_KEY_NoSymbol)); /* ERR: 9 digits */
    assert(test_string("U+4567", XKB_KEY_NoSymbol));     /* ERR: Standard Unicode notation */
    assert(test_string("U+4567ffff", XKB_KEY_NoSymbol));
    assert(test_string("U+4567ffffff", XKB_KEY_NoSymbol));
    assert(test_string("U-456", XKB_KEY_NoSymbol)); /* No negative number */
    assert(test_string("U456w", XKB_KEY_NoSymbol)); /* Not hexadecimal digit */
    assert(test_string("U4567   ", XKB_KEY_NoSymbol));
    assert(test_string("   U4567", XKB_KEY_NoSymbol));
    assert(test_string("U   4567", XKB_KEY_NoSymbol));
    assert(test_string("U  +4567", XKB_KEY_NoSymbol));
    assert(test_string("u4567", XKB_KEY_NoSymbol)); /* Require XKB_KEYSYM_CASE_INSENSITIVE */

    /* Hexadecimal: test ranges */
    assert(test_string(STRINGIFY2(XKB_KEYSYM_MIN), XKB_KEY_NoSymbol)); /* Min keysym */
    assert(test_string("0x1", 0x00000001));
    assert(test_string("0x01234567", 0x01234567));
    assert(test_string("0x09abcdef", 0x09abcdef));
    assert(test_string(STRINGIFY2(XKB_KEYSYM_UNICODE_OFFSET),
                       XKB_KEYSYM_UNICODE_OFFSET));
    assert(test_string("0x01000001", 0x01000001));
    assert(test_string("0x0100000a", 0x0100000a));
    assert(test_string("0x0100001f", 0x0100001f));
    assert(test_string("0x01000020", 0x01000020));
    assert(test_string("0x0100007e", 0x0100007e));
    assert(test_string("0x0100007f", 0x0100007f));
    assert(test_string("0x01000080", 0x01000080));
    assert(test_string("0x0100009f", 0x0100009f));
    assert(test_string("0x010000a0", 0x010000a0));
    assert(test_string("0x010000ff", 0x010000ff));
    assert(test_string(STRINGIFY2(XKB_KEYSYM_UNICODE_MIN),
                       XKB_KEYSYM_UNICODE_MIN));
    assert(test_string("0x0100d7ff", 0x0100d7ff));
    assert(test_string(STRINGIFY2(XKB_KEYSYM_UNICODE_SURROGATE_MIN),
                       XKB_KEYSYM_UNICODE_SURROGATE_MIN));
    assert(test_string(STRINGIFY2(XKB_KEYSYM_UNICODE_SURROGATE_MAX),
                       XKB_KEYSYM_UNICODE_SURROGATE_MAX));
    assert(test_string("0x0100e000", 0x0100e000));
    assert(test_string("0x0100fdcf", 0x0100fdcf));
    assert(test_string("0x0100fdd0", 0x0100fdd0)); /* Noncharacter */
    assert(test_string("0x0100fdef", 0x0100fdef)); /* Noncharacter */
    assert(test_string("0x0100fdf0", 0x0100fdf0));
    assert(test_string("0x0100fffd", 0x0100fffd));
    assert(test_string("0x0100fffe", 0x0100fffe)); /* Noncharacter */
    assert(test_string("0x0100ffff", 0x0100ffff)); /* Noncharacter */
    assert(test_string("0x01010000", 0x01010000));
    assert(test_string("0x0101fffe", 0x0101fffe)); /* Noncharacter */
    assert(test_string("0x0101ffff", 0x0101ffff)); /* Noncharacter */
    assert(test_string(STRINGIFY2(XKB_KEYSYM_UNICODE_MAX),
                       XKB_KEYSYM_UNICODE_MAX));
    assert(test_string("0x01110000", 0x1110000)); /* XKB_KEYSYM_UNICODE_MAX + 1 */
    assert(test_string(STRINGIFY2(XKB_KEYSYM_MAX), XKB_KEYSYM_MAX)); /* Max keysym */
    assert(test_string("0x20000000", XKB_KEY_NoSymbol));
    assert(test_string("0xffffffff", XKB_KEY_NoSymbol));
    assert(test_string("0x100000000", XKB_KEY_NoSymbol));
    /* Hexadecimal: test syntax */
    assert(test_string("0x10203040", 0x10203040));        /* OK:  8 digits */
    assert(test_string("0x102030400", XKB_KEY_NoSymbol)); /* ERR: 9 digits */
    assert(test_string("0x01020304", 0x1020304));         /* OK:  8 digits, starts with 0 */
    assert(test_string("0x010203040", XKB_KEY_NoSymbol)); /* ERR: 9 digits, starts with 0 */
    assert(test_string("0x+10203040", XKB_KEY_NoSymbol));
    assert(test_string("0x01020304w", XKB_KEY_NoSymbol)); /* Not hexadecimal digit */
    assert(test_string("0x102030  ", XKB_KEY_NoSymbol));
    assert(test_string("0x  102030", XKB_KEY_NoSymbol));
    assert(test_string("  0x102030", XKB_KEY_NoSymbol));
    assert(test_string("0x  +10203040", XKB_KEY_NoSymbol));
    assert(test_string("0x-10203040", XKB_KEY_NoSymbol));
    assert(test_string("0X10203040", XKB_KEY_NoSymbol)); /* Require XKB_KEYSYM_CASE_INSENSITIVE */
    assert(test_string("10203040", XKB_KEY_NoSymbol)); /* Missing prefix/decimal not implemented */
    assert(test_string("0b0101", XKB_KEY_NoSymbol)); /* Wrong prefix: binary not implemented */
    assert(test_string("0o0701", XKB_KEY_NoSymbol)); /* Wrong prefix: octal not implemented */

    assert(test_keysym(0x1008FF56, "XF86Close"));
    assert(test_keysym(0x0, "NoSymbol"));
    assert(test_keysym(0x1008FE20, "XF86Ungrab"));
    assert(test_keysym(XKB_KEYSYM_UNICODE_OFFSET, "0x01000000"));
    /* Longest names */
    assert(test_keysym(XKB_KEY_LONGEST_NAME, LONGEST_NAME));
    assert(test_keysym(XKB_KEY_LONGEST_CANONICAL_NAME, LONGEST_CANONICAL_NAME));
    /* Canonical names */
    assert(test_keysym(XKB_KEY_Henkan, "Henkan_Mode"));
    assert(test_keysym(XKB_KEY_Mode_switch, "ISO_Group_Shift"));
    assert(test_keysym(XKB_KEY_ISO_Group_Shift, "ISO_Group_Shift"));
    assert(test_keysym(XKB_KEY_dead_perispomeni, "dead_tilde"));
    assert(test_keysym(XKB_KEY_guillemetleft, "guillemotleft"));
    assert(test_keysym(XKB_KEY_ordmasculine, "masculine"));
    assert(test_keysym(XKB_KEY_Greek_lambda, "Greek_lamda"));
    assert(test_keysym(XKB_KEY_dead_schwa, "dead_small_schwa"));
    assert(test_keysym(XKB_KEY_dead_SCHWA, "dead_capital_schwa"));
    /* Unicode: ISO-8859-1 (Latin-1 + C0 and C1 control code) */
    assert(test_keysym(XKB_KEYSYM_UNICODE_OFFSET, STRINGIFY2(XKB_KEYSYM_UNICODE_OFFSET)));
    assert(test_keysym(0x01000001, "0x01000001"));
    assert(test_keysym(0x0100000a, "0x0100000a"));
    assert(test_keysym(0x0100001f, "0x0100001f"));
    assert(test_keysym(0x01000020, "0x01000020"));
    assert(test_keysym(0x0100007e, "0x0100007e"));
    assert(test_keysym(0x0100007f, "0x0100007f"));
    assert(test_keysym(0x01000080, "0x01000080"));
    assert(test_keysym(0x0100009f, "0x0100009f"));
    assert(test_keysym(0x010000a0, "0x010000a0"));
    assert(test_keysym(0x010000ff, "0x010000ff"));
    /* Min Unicode */
    assert(test_keysym(XKB_KEYSYM_UNICODE_MIN, "U0100"));
    assert(test_keysym(0x01001234, "U1234"));
    /* 16-bit unicode padded to width 4. */
    assert(test_keysym(0x010002DE, "U02DE"));
    /* 32-bit unicode padded to width 8. */
    assert(test_keysym(0x0101F4A9, "U1F4A9"));
    /* Surrogates */
    assert(test_keysym(0x0100d7ff, "UD7FF"));
    assert(test_keysym(XKB_KEYSYM_UNICODE_SURROGATE_MIN, "UD800"));
    assert(test_keysym(XKB_KEYSYM_UNICODE_SURROGATE_MAX, "UDFFF"));
    assert(test_keysym(0x0100e000, "UE000"));
    /* Misc. */
    assert(test_keysym(0x0100fdcf, "UFDCF"));
    /* Noncharacters */
    assert(test_keysym(0x0100fdd0, "UFDD0"));
    assert(test_keysym(0x0100fdef, "UFDEF"));
    /* Misc */
    assert(test_keysym(0x0100fdf0, "UFDF0"));
    assert(test_keysym(0x0100fffd, "UFFFD"));
    /* Noncharacters */
    assert(test_keysym(0x0100fffe, "UFFFE"));
    assert(test_keysym(0x0100ffff, "UFFFF"));
    /* Misc */
    assert(test_keysym(0x01010000, "U10000"));
    /* Max Unicode */
    assert(test_keysym(XKB_KEYSYM_UNICODE_MAX, "U10FFFF"));
    /* Max Unicode + 1 */
    assert(test_keysym(0x01110000, "0x01110000"));
    /* Min keysym. */
    assert(test_keysym(XKB_KEYSYM_MIN, "NoSymbol"));
    /* Max keysym. */
    assert(test_keysym(XKB_KEYSYM_MAX, STRINGIFY2(XKB_KEYSYM_MAX)));
    /* Outside range. */
    assert(test_keysym(XKB_KEYSYM_MAX + 1, "Invalid"));
    assert(test_keysym(0xffffffff, "Invalid"));

    /* Name is assumed to be correct but we provide garbage */
    const char garbage_name[] = "bla bla bla";
    assert(test_deprecated(XKB_KEY_NoSymbol, NULL, false, NULL));
    assert(test_deprecated(XKB_KEY_NoSymbol, "NoSymbol", false, NULL));
    assert(test_deprecated(XKB_KEY_A, "A", false, NULL));
    assert(test_deprecated(XKB_KEY_A, NULL, false, NULL));
    assert(test_deprecated(XKB_KEY_A, garbage_name, false, NULL));
    assert(test_deprecated(XKB_KEY_ETH, "ETH", false, "ETH"));
    assert(test_deprecated(XKB_KEY_ETH, "Eth", true, "ETH"));
    assert(test_deprecated(XKB_KEY_ETH, garbage_name, true, "ETH"));
    assert(test_deprecated(XKB_KEY_topleftradical, NULL, true, NULL));
    assert(test_deprecated(XKB_KEY_topleftradical, "topleftradical", true, NULL));
    assert(test_deprecated(XKB_KEY_topleftradical, garbage_name, true, NULL));
    assert(test_deprecated(XKB_KEY_downcaret, NULL, true, NULL));
    assert(test_deprecated(XKB_KEY_downcaret, "downcaret", true, NULL));
    /* Mixed deprecated and not deprecated aliases */
    assert(test_deprecated(XKB_KEY_Mode_switch, NULL, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_Mode_switch, "Mode_switch", false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_Mode_switch, garbage_name, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_ISO_Group_Shift, NULL, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_ISO_Group_Shift, "ISO_Group_Shift", false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_ISO_Group_Shift, garbage_name, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_dead_capital_schwa, NULL, false, "dead_SCHWA"));
    assert(test_deprecated(XKB_KEY_dead_capital_schwa, "dead_capital_schwa", true, "dead_SCHWA"));
    assert(test_deprecated(XKB_KEY_dead_capital_schwa, "dead_SCHWA", false, "dead_SCHWA"));
    assert(test_deprecated(XKB_KEY_dead_capital_schwa, garbage_name, true, "dead_SCHWA"));
    assert(test_deprecated(XKB_KEY_SunAltGraph, NULL, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_SunAltGraph, "SunAltGraph", true, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_SunAltGraph, garbage_name, false, "ISO_Group_Shift"));
    assert(test_deprecated(XKB_KEY_notapproxeq, "notapproxeq", true, NULL));
    assert(test_deprecated(XKB_KEY_approxeq, "approxeq", true, NULL));
    /* Unicode is never deprecated */
    assert(test_deprecated(0x01002247, "U2247", false, NULL));
    assert(test_deprecated(0x01002248, "U2248", false, NULL));
    assert(test_deprecated(0x0100250C, "U250C", false, NULL));
    assert(test_deprecated(0x0100250C, "0x0100250C", false, NULL));
    assert(test_deprecated(XKB_KEYSYM_MAX, NULL, false, NULL));
    assert(test_deprecated(XKB_KEYSYM_MAX, NULL, false, NULL));
    /* Invalid keysym */
    assert(test_deprecated(0xffffffff, NULL, false, NULL));
    assert(test_deprecated(0xffffffff, NULL, false, NULL));

    assert(test_casestring("Undo", 0xFF65));
    assert(test_casestring("UNDO", 0xFF65));
    assert(test_casestring("A", 0x61));
    assert(test_casestring("a", 0x61));
    assert(test_casestring("ThisKeyShouldNotExist", XKB_KEY_NoSymbol));
    assert(test_casestring("XF86_Switch_vT_5", 0x1008FE05));
    assert(test_casestring("xF86_SwitcH_VT_5", 0x1008FE05));
    assert(test_casestring("xF86SwiTch_VT_5", 0x1008FE05));
    assert(test_casestring("xF86Switch_vt_5", 0x1008FE05));
    assert(test_casestring("VoidSymbol", 0xFFFFFF));
    assert(test_casestring("vOIDsymBol", 0xFFFFFF));
    assert(test_casestring("U4567", 0x1004567));
    assert(test_casestring("u4567", 0x1004567));
    assert(test_casestring("0x10203040", 0x10203040));
    assert(test_casestring("0X10203040", 0x10203040));
    assert(test_casestring("THORN", 0x00fe));
    assert(test_casestring("Thorn", 0x00fe));
    assert(test_casestring("thorn", 0x00fe));

    for (size_t k = 0; k < ARRAY_SIZE(ambiguous_icase_ks_names); k++) {
        test_ambiguous_icase_names(&ambiguous_icase_ks_names[k]);
    }

    assert(test_string("", XKB_KEY_NoSymbol));
    assert(test_casestring("", XKB_KEY_NoSymbol));

    assert(xkb_utf8_to_keysym(NULL, 0) == XKB_KEY_NoSymbol);
    assert(xkb_utf8_to_keysym("", 1) == XKB_KEY_NoSymbol);
    assert(xkb_utf8_to_keysym("1", 2) == XKB_KEY_1);
    assert(xkb_utf8_to_keysym("12", 2) == XKB_KEY_1); /* Only first codepoint */

    /* Latin-1 keysyms (1:1 mapping in UTF-32) */
    assert(test_utf8(0x0020, "\x20"));
    assert(test_utf8(0x007e, "\x7e"));
    assert(test_utf8(0x00a0, "\xc2\xa0"));
    assert(test_utf8(0x00ff, "\xc3\xbf"));

    assert(test_utf8(XKB_KEY_y, "y"));
    assert(test_utf8(XKB_KEY_u, "u"));
    assert(test_utf8(XKB_KEY_m, "m"));
    assert(test_utf8(XKB_KEY_Cyrillic_em, "м"));
    assert(test_utf8(XKB_KEY_Cyrillic_u, "у"));
    assert(test_utf8(XKB_KEY_exclam, "!"));
    assert(test_utf8(XKB_KEY_oslash, "ø"));
    assert(test_utf8(XKB_KEY_hebrew_aleph, "א"));
    assert(test_utf8(XKB_KEY_Arabic_sheen, "ش"));

    /* Keysyms with special handling */
    assert(test_utf8(XKB_KEY_space, " "));
    assert(test_utf8(XKB_KEY_KP_Space, " "));
    assert(test_utf8(XKB_KEY_BackSpace, "\b"));
    assert(test_utf8(XKB_KEY_Escape, "\033"));
    assert(test_utf8(XKB_KEY_KP_Separator, ","));
    assert(test_utf8(XKB_KEY_KP_Decimal, "."));
    assert(test_utf8(XKB_KEY_Tab, "\t"));
    assert(test_utf8(XKB_KEY_KP_Tab, "\t"));
    assert(test_utf8(XKB_KEY_hyphen, "­"));
    assert(test_utf8(XKB_KEY_Linefeed, "\n"));
    assert(test_utf8(XKB_KEY_Return, "\r"));
    assert(test_utf8(XKB_KEY_KP_Enter, "\r"));
    assert(test_utf8(XKB_KEY_KP_Equal, "="));
    assert(test_utf8(XKB_KEY_asterisk, "*"));
    assert(test_utf8(XKB_KEY_KP_Multiply, "*"));
    assert(test_utf8(XKB_KEY_XF86NumericStar, "*"));
    assert(test_utf8(XKB_KEY_plus, "+"));
    assert(test_utf8(XKB_KEY_KP_Add, "+"));
    assert(test_utf8(XKB_KEY_minus, "-"));
    assert(test_utf8(XKB_KEY_KP_Subtract, "-"));
    assert(test_utf8(XKB_KEY_slash, "/"));
    assert(test_utf8(XKB_KEY_KP_Divide, "/"));
    assert(test_utf8(XKB_KEY_numbersign, "#"));
    assert(test_utf8(XKB_KEY_XF86NumericPound, "#"));
    assert(test_utf8(XKB_KEY_9, "9"));
    assert(test_utf8(XKB_KEY_KP_0, "0"));
    assert(test_utf8(XKB_KEY_KP_1, "1"));
    assert(test_utf8(XKB_KEY_KP_2, "2"));
    assert(test_utf8(XKB_KEY_KP_3, "3"));
    assert(test_utf8(XKB_KEY_KP_4, "4"));
    assert(test_utf8(XKB_KEY_KP_5, "5"));
    assert(test_utf8(XKB_KEY_KP_6, "6"));
    assert(test_utf8(XKB_KEY_KP_7, "7"));
    assert(test_utf8(XKB_KEY_KP_8, "8"));
    assert(test_utf8(XKB_KEY_KP_9, "9"));
    assert(test_utf8(XKB_KEY_XF86Numeric0, "0"));
    assert(test_utf8(XKB_KEY_XF86Numeric1, "1"));
    assert(test_utf8(XKB_KEY_XF86Numeric2, "2"));
    assert(test_utf8(XKB_KEY_XF86Numeric3, "3"));
    assert(test_utf8(XKB_KEY_XF86Numeric4, "4"));
    assert(test_utf8(XKB_KEY_XF86Numeric5, "5"));
    assert(test_utf8(XKB_KEY_XF86Numeric6, "6"));
    assert(test_utf8(XKB_KEY_XF86Numeric7, "7"));
    assert(test_utf8(XKB_KEY_XF86Numeric8, "8"));
    assert(test_utf8(XKB_KEY_XF86Numeric9, "9"));

    /* These are function keys, not letters */
    assert(test_utf8(XKB_KEY_XF86NumericA, NULL));
    assert(test_utf8(XKB_KEY_XF86NumericB, NULL));
    assert(test_utf8(XKB_KEY_XF86NumericC, NULL));
    assert(test_utf8(XKB_KEY_XF86NumericD, NULL));

    /* Unicode keysyms */
    assert(test_utf8(XKB_KEYSYM_UNICODE_OFFSET, NULL)); /* Min Unicode codepoint */
    assert(test_utf8(0x1000001, "\x01"));     /* Currently accepted, but not intended (< 0x100100) */
    assert(test_utf8(0x1000020, " "));        /* Currently accepted, but not intended (< 0x100100) */
    assert(test_utf8(0x100007f, "\x7f"));     /* Currently accepted, but not intended (< 0x100100) */
    assert(test_utf8(0x10000a0, "\xc2\xa0")); /* Currently accepted, but not intended (< 0x100100) */
    assert(test_utf8(XKB_KEYSYM_UNICODE_MIN, "Ā")); /* Min Unicode keysym */
    assert(test_utf8(0x10005d0, "א"));
    assert(test_utf8(XKB_KEYSYM_UNICODE_MAX, "\xf4\x8f\xbf\xbf")); /* Max Unicode */
    assert(test_utf8(XKB_KEYSYM_UNICODE_SURROGATE_MIN, NULL));
    assert(test_utf8(XKB_KEYSYM_UNICODE_SURROGATE_MAX, NULL));
    assert(test_utf8(XKB_KEYSYM_UNICODE_MAX + 1, NULL));

    assert(test_utf32_to_keysym('y', XKB_KEY_y));
    assert(test_utf32_to_keysym('u', XKB_KEY_u));
    assert(test_utf32_to_keysym('m', XKB_KEY_m));
    assert(test_utf32_to_keysym(0x43c, XKB_KEY_Cyrillic_em));
    assert(test_utf32_to_keysym(0x443, XKB_KEY_Cyrillic_u));
    assert(test_utf32_to_keysym('!', XKB_KEY_exclam));
    assert(test_utf32_to_keysym(0xF8, XKB_KEY_oslash));
    assert(test_utf32_to_keysym(0x5D0, XKB_KEY_hebrew_aleph));
    assert(test_utf32_to_keysym(0x634, XKB_KEY_Arabic_sheen));
    assert(test_utf32_to_keysym(0x1F609, 0x0101F609)); // ;) emoji

    assert(test_utf32_to_keysym('\b', XKB_KEY_BackSpace));
    assert(test_utf32_to_keysym('\t', XKB_KEY_Tab));
    assert(test_utf32_to_keysym('\n', XKB_KEY_Linefeed));
    assert(test_utf32_to_keysym(0x0b, XKB_KEY_Clear));
    assert(test_utf32_to_keysym('\r', XKB_KEY_Return));
    assert(test_utf32_to_keysym(0x1b, XKB_KEY_Escape));
    assert(test_utf32_to_keysym(0x7f, XKB_KEY_Delete));

    /* Not keypad nor phone keys */
    assert(test_utf32_to_keysym(' ', XKB_KEY_space));
    assert(test_utf32_to_keysym('\t', XKB_KEY_Tab));
    assert(test_utf32_to_keysym('\r', XKB_KEY_Return));
    assert(test_utf32_to_keysym(',', XKB_KEY_comma));
    assert(test_utf32_to_keysym('.', XKB_KEY_period));
    assert(test_utf32_to_keysym('=', XKB_KEY_equal));
    assert(test_utf32_to_keysym('0', XKB_KEY_0));
    assert(test_utf32_to_keysym('1', XKB_KEY_1));
    assert(test_utf32_to_keysym('2', XKB_KEY_2));
    assert(test_utf32_to_keysym('3', XKB_KEY_3));
    assert(test_utf32_to_keysym('4', XKB_KEY_4));
    assert(test_utf32_to_keysym('5', XKB_KEY_5));
    assert(test_utf32_to_keysym('6', XKB_KEY_6));
    assert(test_utf32_to_keysym('7', XKB_KEY_7));
    assert(test_utf32_to_keysym('8', XKB_KEY_8));
    assert(test_utf32_to_keysym('9', XKB_KEY_9));
    assert(test_utf32_to_keysym('A', XKB_KEY_A));
    assert(test_utf32_to_keysym('B', XKB_KEY_B));
    assert(test_utf32_to_keysym('C', XKB_KEY_C));
    assert(test_utf32_to_keysym('D', XKB_KEY_D));
    assert(test_utf32_to_keysym('E', XKB_KEY_E));
    assert(test_utf32_to_keysym('F', XKB_KEY_F));
    assert(test_utf32_to_keysym('#', XKB_KEY_numbersign));
    assert(test_utf32_to_keysym('+', XKB_KEY_plus));
    assert(test_utf32_to_keysym('-', XKB_KEY_minus));
    assert(test_utf32_to_keysym('*', XKB_KEY_asterisk));
    assert(test_utf32_to_keysym(0xd7, XKB_KEY_multiply));
    assert(test_utf32_to_keysym('/', XKB_KEY_slash));

    assert(test_utf32_to_keysym(0x10fffd, 0x110fffd));
    assert(test_utf32_to_keysym(0x20ac, XKB_KEY_EuroSign));

    // Unicode noncharacters
    assert(test_utf32_to_keysym(0xd800, XKB_KEY_NoSymbol)); // Unicode first surrogate
    assert(test_utf32_to_keysym(0xdfff, XKB_KEY_NoSymbol)); // Unicode last surrogate
    assert(test_utf32_to_keysym(0xfdd0, 0x100fdd0));
    assert(test_utf32_to_keysym(0xfdef, 0x100fdef));
    assert(test_utf32_to_keysym(0xfffe, 0x100fffe));
    assert(test_utf32_to_keysym(0xffff, 0x100ffff));
    assert(test_utf32_to_keysym(0x7fffe, 0x107fffe));
    assert(test_utf32_to_keysym(0x7ffff, 0x107ffff));
    assert(test_utf32_to_keysym(0xafffe, 0x10afffe));
    assert(test_utf32_to_keysym(0xaffff, 0x10affff));

    // Codepoints outside the Unicode planes
    assert(test_utf32_to_keysym(0x110000, XKB_KEY_NoSymbol));
    assert(test_utf32_to_keysym(0xdeadbeef, XKB_KEY_NoSymbol));

    assert(xkb_keysym_is_lower(XKB_KEY_a));
    assert(xkb_keysym_is_lower(XKB_KEY_Greek_lambda));
    assert(xkb_keysym_is_lower(xkb_keysym_from_name("U03b1", 0))); /* GREEK SMALL LETTER ALPHA */
    assert(xkb_keysym_is_lower(xkb_keysym_from_name("U03af", 0))); /* GREEK SMALL LETTER IOTA WITH TONOS */

    assert(xkb_keysym_is_upper_or_title(XKB_KEY_A));
    assert(xkb_keysym_is_upper_or_title(XKB_KEY_Greek_LAMBDA));
    assert(xkb_keysym_is_upper_or_title(xkb_keysym_from_name("U0391", 0))); /* GREEK CAPITAL LETTER ALPHA */
    assert(xkb_keysym_is_upper_or_title(xkb_keysym_from_name("U0388", 0))); /* GREEK CAPITAL LETTER EPSILON WITH TONOS */

    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_a));
    assert(!xkb_keysym_is_lower(XKB_KEY_A));
    assert(!xkb_keysym_is_lower(XKB_KEY_Return));
    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_Return));
    assert(!xkb_keysym_is_lower(XKB_KEY_hebrew_aleph));
    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_hebrew_aleph));
    assert(!xkb_keysym_is_upper_or_title(xkb_keysym_from_name("U05D0", 0))); /* HEBREW LETTER ALEF */
    assert(!xkb_keysym_is_lower(xkb_keysym_from_name("U05D0", 0))); /* HEBREW LETTER ALEF */
    assert(!xkb_keysym_is_lower(XKB_KEY_8));
    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_8));

    assert(xkb_keysym_is_keypad(XKB_KEY_KP_Enter));
    assert(xkb_keysym_is_keypad(XKB_KEY_KP_6));
    assert(xkb_keysym_is_keypad(XKB_KEY_KP_Add));
    assert(!xkb_keysym_is_keypad(XKB_KEY_Num_Lock));
    assert(!xkb_keysym_is_keypad(XKB_KEY_1));
    assert(!xkb_keysym_is_keypad(XKB_KEY_Return));

    assert(xkb_keysym_to_upper(XKB_KEY_a) == XKB_KEY_A);
    assert(xkb_keysym_to_upper(XKB_KEY_A) == XKB_KEY_A);
    assert(xkb_keysym_to_lower(XKB_KEY_a) == XKB_KEY_a);
    assert(xkb_keysym_to_lower(XKB_KEY_A) == XKB_KEY_a);
    assert(xkb_keysym_to_upper(XKB_KEY_Return) == XKB_KEY_Return);
    assert(xkb_keysym_to_lower(XKB_KEY_Return) == XKB_KEY_Return);
    assert(xkb_keysym_to_upper(XKB_KEY_Greek_lambda) == XKB_KEY_Greek_LAMBDA);
    assert(xkb_keysym_to_upper(XKB_KEY_Greek_LAMBDA) == XKB_KEY_Greek_LAMBDA);
    assert(xkb_keysym_to_lower(XKB_KEY_Greek_lambda) == XKB_KEY_Greek_lambda);
    assert(xkb_keysym_to_lower(XKB_KEY_Greek_LAMBDA) == XKB_KEY_Greek_lambda);
    assert(xkb_keysym_to_upper(XKB_KEY_eacute) == XKB_KEY_Eacute);
    assert(xkb_keysym_to_lower(XKB_KEY_Eacute) == XKB_KEY_eacute);

    /* S sharp
     * • U+00DF ß: lower case
     * •       SS: upper case (special mapping, not handled by us)
     * • U+1E9E ẞ: upper case, only for capitals
     */
    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_ssharp));
    assert(xkb_keysym_is_upper_or_title(XKB_KEY_SSHARP));
    assert(xkb_keysym_is_lower(XKB_KEY_ssharp));
    assert(!xkb_keysym_is_lower(XKB_KEY_SSHARP));
    assert(xkb_keysym_to_upper(XKB_KEY_ssharp) == XKB_KEY_SSHARP);
    assert(xkb_keysym_to_lower(XKB_KEY_ssharp) == XKB_KEY_ssharp);
    assert(xkb_keysym_to_upper(XKB_KEY_SSHARP) == XKB_KEY_SSHARP);
    assert(xkb_keysym_to_lower(XKB_KEY_SSHARP) == XKB_KEY_ssharp);

    /* Title case: simple mappings
     * • U+01F1 DZ: upper case
     * • U+01F2 Dz: title case
     * • U+01F3 dz: lower case
     */
#ifndef XKB_KEY_DZ
#define XKB_KEY_DZ (XKB_KEYSYM_UNICODE_OFFSET + 0x01F1)
#endif
#ifndef XKB_KEY_Dz
#define XKB_KEY_Dz (XKB_KEYSYM_UNICODE_OFFSET + 0x01F2)
#endif
#ifndef XKB_KEY_dz
#define XKB_KEY_dz (XKB_KEYSYM_UNICODE_OFFSET + 0x01F3)
#endif
    assert(xkb_keysym_is_upper_or_title(XKB_KEY_DZ));
    assert(xkb_keysym_is_upper_or_title(XKB_KEY_Dz));
    assert(!xkb_keysym_is_upper_or_title(XKB_KEY_dz));
    assert(!xkb_keysym_is_lower(XKB_KEY_DZ));
    assert(!xkb_keysym_is_lower(XKB_KEY_Dz));
    assert(xkb_keysym_is_lower(XKB_KEY_dz));
    assert(xkb_keysym_to_upper(XKB_KEY_DZ) == XKB_KEY_DZ);
    assert(xkb_keysym_to_lower(XKB_KEY_DZ) == XKB_KEY_dz);
    assert(xkb_keysym_to_upper(XKB_KEY_Dz) == XKB_KEY_DZ);
    assert(xkb_keysym_to_lower(XKB_KEY_Dz) == XKB_KEY_dz);
    assert(xkb_keysym_to_upper(XKB_KEY_dz) == XKB_KEY_DZ);
    assert(xkb_keysym_to_lower(XKB_KEY_dz) == XKB_KEY_dz);

    /* Title case: special mappings
     * • U+1F80         ᾀ: lower case
     * • U+1F88         ᾈ: title case
     * • U+1F88         ᾈ: upper case (simple)
     * • U+1F08 U+0399 ἈΙ: upper case (full)
     *
     * We do not handle special upper mapping
     */
    assert(!xkb_keysym_is_upper_or_title(XKB_KEYSYM_UNICODE_OFFSET + 0x1F80));
    assert(xkb_keysym_is_upper_or_title(XKB_KEYSYM_UNICODE_OFFSET + 0x1F88));
    assert(xkb_keysym_is_lower(XKB_KEYSYM_UNICODE_OFFSET + 0x1F80));
    assert(!xkb_keysym_is_lower(XKB_KEYSYM_UNICODE_OFFSET + 0x1F88));
    assert(xkb_keysym_to_upper(XKB_KEYSYM_UNICODE_OFFSET + 0x1F80) == XKB_KEYSYM_UNICODE_OFFSET + 0x1F88);
    assert(xkb_keysym_to_lower(XKB_KEYSYM_UNICODE_OFFSET + 0x1F80) == XKB_KEYSYM_UNICODE_OFFSET + 0x1F80);
    assert(xkb_keysym_to_upper(XKB_KEYSYM_UNICODE_OFFSET + 0x1F88) == XKB_KEYSYM_UNICODE_OFFSET + 0x1F88);
    assert(xkb_keysym_to_lower(XKB_KEYSYM_UNICODE_OFFSET + 0x1F88) == XKB_KEYSYM_UNICODE_OFFSET + 0x1F80);

    test_github_issue_42();

    return 0;
}