Function sdl2_sys::SDL_GetScancodeName
source · pub unsafe extern "C" fn SDL_GetScancodeName(
scancode: SDL_Scancode,
) -> *const c_char
Expand description
Get a human-readable name for a scancode.
See SDL_Scancode for details.
Warning: The returned name is by design not stable across platforms,
e.g. the name for SDL_SCANCODE_LGUI
is “Left GUI” under Linux but “Left
Windows” under Microsoft Windows, and some scancodes like
SDL_SCANCODE_NONUSBACKSLASH
don’t have any name at all. There are even
scancodes that share names, e.g. SDL_SCANCODE_RETURN
and
SDL_SCANCODE_RETURN2
(both called “Return”). This function is therefore
unsuitable for creating a stable cross-platform two-way mapping between
strings and scancodes.
\param scancode the desired SDL_Scancode to query \returns a pointer to the name for the scancode. If the scancode doesn’t have a name this function returns an empty string (“”).
\since This function is available since SDL 2.0.0.
\sa SDL_GetScancodeFromKey \sa SDL_GetScancodeFromName