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.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

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