目次 - SDL 3.0 API(機能別) - キーボード - SDL_GetScancodeName

SDL_GetScancodeName

スキャンコードの人が読める名前を得る

ヘッダ

SDL3/SDL_keyboard.h

構文

const char * SDL_GetScancodeName(SDL_Scancode scancode);

引数

SDL_Scancodescancode問い合わせるスキャンコード

戻り値

(const char *) UTF-8文字列のスキャンコード名を戻す. スキャンコードに名前がない場合, この関数は空の文字列("")を戻す.

詳細

注意: この関数が戻す名前は, 動作する環境間で同じではない設計になっている. 例えば, SDL_SCANCODE_LGUIはLinuxでは"Left GUI"だが, Microsoft Windowsでは"Left Windows"である. そして, 一部のSDL_SCANCODE_NONUSBACKSLASHのようなスキャンコードには名前がまったくない. 同じ名前のスキャンコードのある. 例えば, SDL_SCANCODE_RETURNとSDL_SCANCODE_RETURN2はどちらも"Return"である. そのため, この関数は複数の環境での安定した文字列とスキャンコードの双方向の対応付けを作成するには向いていない.

スレッドセーフ

この関数はスレッドセーフではない.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetScancodeName - SDL Wiki