const char * SDL_GetError(void);
(const char *) 発生したエラーの情報のメッセージを戻す. または, SDL_ClearError()を呼んでからエラーがなければ, 空の文字列を戻す.
SDL_GetError()を呼ぶ前に複数のエラーが発生する可能性がある. この場合, 最後のエラーメッセージのみ戻す.
このメッセージはSDL関数がエラーを発した場合のみ使用できる. SDL_GetError()を呼べるか否かは, SDL関数の戻り値をチェックする必要がある. エラーが発生したかを確認するためにSDL_GetError()の結果を利用すべきではない! SDLは正常を報告してもエラー文字列を設定する場合がある.
SDLはAPI呼び出しに成功してもエラー文字列を消去しない. エラー文字列を使う前に, 戻り値でエラーを確認する必要がある.
エラー文字列はスレッドごとに設定される. よって, 別のスレッドで発生したエラーは現在のスレッドでの操作には影響しない.
戻された値はスレッドローカルな文字列で, スレッドのエラー文字列が変わるまで正しい値として保持される. この値が次のSDL API呼び出しの後でも必要な場合は, 呼び出し側でコピーする必要がある.
この関数はどのスレッドからも安全に呼べる.