NAME

SDL_GetGamepadMapping - Get the current mapping of a gamepad.

SYNOPSIS

#include <SDL3/SDL_gamepad.h>

char * SDL_GetGamepadMapping(SDL_Gamepad *gamepad);

DESCRIPTION

Details about mappings are discussed with SDL_AddGamepadMapping().

FUNCTION PARAMETERS

gamepad

the gamepad you want to get the current mapping for.

RETURN VALUE

Returns a string that has the gamepad's mapping or NULL if no mapping is available; call SDL_GetError() for more information. This should be freed with SDL_free() when it is no longer needed.

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.2.0.

SEE ALSO

SDL_AddGamepadMapping(3), SDL_GetGamepadMappingForID(3), SDL_GetGamepadMappingForGUID(3), SDL_SetGamepadMapping(3)