Wiki Page Content

Differences between revisions 5 and 6
Revision 5 as of 2013-10-13 11:43:42
Size: 1897
Comment: Fixed syntax errors in C++ example and changed it to C.
Revision 6 as of 2015-12-04 23:08:58
Size: 1664
Comment: Added remark.
Deletions are marked like this. Additions are marked like this.
Line 49: Line 49:
''You can add useful comments here''

##Leave this section as-is unless you have a remark to put in. In that case, replace ''You can add useful comments here'' with your remark(s) following the Style Guide instructions. Leave the rest of the markup alone and delete this comment.
The returned string must be freed with SDL_free().



Use this function to get the current mapping of a Game Controller.


char* SDL_GameControllerMapping(SDL_GameController* gamecontroller)

Function Parameters


the game controller you want to get the current mapping for

Return Value

Returns a string that has the controller's mapping. More information about the mapping can be found on SDL_GameControllerAddMapping; call SDL_GetError() for more information.

Code Examples

#include <stdio.h> /* for printf() */

/* ... */

SDL_GameController *ctrl;
int i;

for (i = 0; i < SDL_NumJoysticks(); ++i) {
    if (SDL_IsGameController(i)) {
        printf("Index \'%i\' is a compatible controller, named \'%s\'\n", i, SDL_GameControllerNameForIndex(i));
        ctrl = SDL_GameControllerOpen(i);
        printf("Controller %i is mapped as \"%s\".\n", i, SDL_GameControllerMapping(ctrl));
    } else {
        printf("Index \'%i\' is not a compatible controller.", i);


The returned string must be freed with SDL_free().

CategoryAPI, CategoryGameController

None: SDL_GameControllerMapping (last edited 2016-04-10 22:39:25 by PhilippWiesemann)

Please include your contact information if you'd like to receive a reply.