This function returns the name of the specified printable key, encoded as UTF-8. This is typically the character that key would produce without any modifier keys, intended for displaying key bindings to the user. For dead keys, it is typically the diacritic it would add to a character.
Do not use this function for text input. You will break text input for many languages even if it happens to work for yours.
If the key is GLFW_KEY_UNKNOWN, the scancode is used to identify the key, otherwise the scancode is ignored. If you specify a non-printable key, or GLFW_KEY_UNKNOWN and a scancode that maps to a non-printable key, this function returns NULL but does not emit an error.
This behavior allows you to always pass in the arguments in the key callback without modification.
The printable keys are:
GLFW_KEY_APOSTROPHE
GLFW_KEY_COMMA
GLFW_KEY_MINUS
GLFW_KEY_PERIOD
GLFW_KEY_SLASH
GLFW_KEY_SEMICOLON
GLFW_KEY_EQUAL
GLFW_KEY_LEFT_BRACKET
GLFW_KEY_RIGHT_BRACKET
GLFW_KEY_BACKSLASH
GLFW_KEY_WORLD_1
GLFW_KEY_WORLD_2
GLFW_KEY_0 to GLFW_KEY_9
GLFW_KEY_A to GLFW_KEY_Z
GLFW_KEY_KP_0 to GLFW_KEY_KP_9
GLFW_KEY_KP_DECIMAL
GLFW_KEY_KP_DIVIDE
GLFW_KEY_KP_MULTIPLY
GLFW_KEY_KP_SUBTRACT
GLFW_KEY_KP_ADD
GLFW_KEY_KP_EQUAL
Names for printable keys depend on keyboard layout, while names for non-printable keys are the same across layouts but depend on the application language and should be localized along with other user interface text.
Parameters
key: number
The key to query, or GLFW_KEY_UNKNOWN.
scancode: number
The scancode of the key to query.
Returns string
The UTF-8 encoded, layout-specific name of the key, or NULL.
This function returns the name of the specified printable key, encoded as UTF-8. This is typically the character that key would produce without any modifier keys, intended for displaying key bindings to the user. For dead keys, it is typically the diacritic it would add to a character.
Do not use this function for text input. You will break text input for many languages even if it happens to work for yours.
If the key is
GLFW_KEY_UNKNOWN, the scancode is used to identify the key, otherwise the scancode is ignored. If you specify a non-printable key, orGLFW_KEY_UNKNOWNand a scancode that maps to a non-printable key, this function returnsNULLbut does not emit an error.This behavior allows you to always pass in the arguments in the key callback without modification.
The printable keys are:
GLFW_KEY_APOSTROPHEGLFW_KEY_COMMAGLFW_KEY_MINUSGLFW_KEY_PERIODGLFW_KEY_SLASHGLFW_KEY_SEMICOLONGLFW_KEY_EQUALGLFW_KEY_LEFT_BRACKETGLFW_KEY_RIGHT_BRACKETGLFW_KEY_BACKSLASHGLFW_KEY_WORLD_1GLFW_KEY_WORLD_2GLFW_KEY_0toGLFW_KEY_9GLFW_KEY_AtoGLFW_KEY_ZGLFW_KEY_KP_0toGLFW_KEY_KP_9GLFW_KEY_KP_DECIMALGLFW_KEY_KP_DIVIDEGLFW_KEY_KP_MULTIPLYGLFW_KEY_KP_SUBTRACTGLFW_KEY_KP_ADDGLFW_KEY_KP_EQUALNames for printable keys depend on keyboard layout, while names for non-printable keys are the same across layouts but depend on the application language and should be localized along with other user interface text.