Wiki Page Content

DRAFT

SDL_GameControllerName

Use this function to get the implementation dependent name for an opened game controller.

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.


CategoryAPI, CategoryGameController

None: SDL_GameControllerName (last edited 2016-04-10 22:25:53 by PhilippWiesemann)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit