SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


THIS PAGE IS A WORK IN PROGRESS ... Please make edits to this page to improve it!


Get the implementation dependent name for the game controller.


const char* SDL_GameControllerNameForIndex(int joystick_index);

Function Parameters


the device_index of a device, from zero to SDL_NumJoysticks()-1

Return Value

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


This function can be called before any controllers are opened.

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


This function is available since SDL 3.0.0.

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);

CategoryAPI, CategoryGameController, CategoryDraft

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.