DRAFT |
SDL_GameControllerName
Use this function to get the implementation dependent name for an opened game controller.
Contents
Syntax
const char* SDL_GameControllerName(SDL_GameController* gamecontroller)
Function Parameters
gamecontroller |
a game controller identifier previously returned by SDL_GameControllerOpen() |
Return Value
Returns the implementation dependent name for the game controller, or NULL if there is no name or the identifier passed is invalid.
Code Examples
SDL_GameController *controller = NULL;
for (int i = 0; i < SDL_NumJoysticks(); ++i) {
controller = SDL_GameControllerOpen(i);
if (controller) {
break;
}
}
if (controller) {
printf("Found a valid controller, named: %s\n", SDL_GameControllerName(controller));
}
Remarks
This is the same name as returned by SDL_GameControllerNameForIndex(), but it takes a controller identifier instead of the (unstable) device index.
Version
This function is available since SDL 2.0.0.
