目次 - API(機能別) - ゲームコントローラー - SDL_GameControllerMapping

# SDL_GameControllerMapping

ゲームコントローラーの現在のマッピングを得る

## 構文

`char* SDL_GameControllerMapping(SDL_GameController* gamecontroller)`

## 引数

gamecontroller | マッピングを得るゲームコントローラー

## 戻り値

ゲームコントローラーのマッピング文字列を戻す. NULLのときマッピングは使えない. SDL_GetError()で詳細を知ることができる.

## サンプルコード

``

    #include "SDL.h"

    /* ... */

    SDL_GameController *ctrl;
    int i;

    SDL_Init(SDL_INIT_GAMECONTROLLER);

    for (i = 0; i < SDL_NumJoysticks(); ++i) {
        if (SDL_IsGameController(i)) {
            char *mapping;
            SDL_Log("\'%d\'番はジョイスティック互換のコントローラ, 名称は\'%s\'", i, SDL_GameControllerNameForIndex(i));
            ctrl = SDL_GameControllerOpen(i);
            mapping = SDL_GameControllerMapping(ctrl);
            SDL_Log("コントローラ %i は \"%s\" にマッピングされた", i, mapping);
            SDL_free(mapping);
        } else {
            SDL_Log("\'%d\'番はジョイスティックと非互換のコントローラ", i);
        }
    }

## 詳細

戻された文字列はSDL_Free()で解放する必要がある.

マッピングの詳細はSDL_GameControllerAddMapping()のページにある.

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_GameControllerAddMapping
SDL_GameControllerMappingForGUID

## SDL Wikiへのリンク

SDL_GameControllerMapping - SDL Wiki