SDL_GetError

構文

戻り値

発生したエラーの情報のメッセージを戻す. または, SDL_ClearError()を呼んでからエラーがなければ, 空の文字列を戻す. SDL_ClearError()を呼んだ場合を除けば, メッセージはSDL関数がエラーを報告した場合のみ変わる. SDL_GetError()を呼ぶかどうかは, SDL関数の戻り値を確認して決める必要がある.

サンプルコード

if (SDL_Init(SDL_INIT_EVERYTHING) < 0) {
    // 回復できないエラー. ここで終了処理を行う
    printf("SDL_Init 失敗: %s\n", SDL_GetError());
}

メモ: このサンプルではSDL_Init()を使っているが, SDL_GetError()はエラーの調査を助けるためにあらゆるSDLの操作の失敗でエラーメッセージを提供している. SDL関数のそれぞれの項目を参照すること.

詳細

SDL_GetError()を呼ぶ前に複数のエラーが発生する可能性がある. この場合, 最後のエラーメッセージのみ戻す.

文字列は静的に確保されているので, アプリケーションは解放してはならない.

関連項目(関数)

SDL Wikiへのリンク