Wiki Page Content

DRAFT

SDL_GameControllerNameForIndex

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

Syntax

const char* SDL_GameControllerNameForIndex(int joystick_index)

Function Parameters

joystick_index

the device_index of a device, up to SDL_NumJoysticks()

Return Value

Returns the implementation dependent name for the game controller, or NULL if there is no name or the index is invalid.

Code Examples

for (int i = 0; i < SDL_NumJoysticks(); ++i) {
    const char *name = SDL_GameControllerNameForIndex(i);
    if (name) {
        printf("Joystick %i has game controller name '%s'\n", i, name);
    } else {
        printf("Joystick %i has no game controller name.\n", i);
    }
}

Remarks

This function can be called before any controllers are opened.

joystick_index is the same as the device_index passed to SDL_JoystickOpen().

Version

This function is available since SDL 2.0.0.


CategoryAPI, CategoryGameController

None: SDL_GameControllerNameForIndex (last edited 2016-04-10 22:45:35 by PhilippWiesemann)

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