NAME

SDL_GetGamepadMappingForID - Get the mapping of a gamepad.

SYNOPSIS

#include <SDL3/SDL_gamepad.h>

char * SDL_GetGamepadMappingForID(SDL_JoystickID instance_id);

DESCRIPTION

This can be called before any gamepads are opened.

FUNCTION PARAMETERS

instance_id

the joystick instance ID.

RETURN VALUE

Returns the mapping string. Returns NULL if no mapping is available. 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_GetGamepads(3), SDL_GetGamepadMapping(3)