目次 - SDL 3.0 API(機能別) - ファイルシステム - SDL_GetBasePath

SDL_GetBasePath

アプリケーションを起動したディレクトリを得る

ヘッダ

SDL3/SDL_filesystem.h

構文

const char * SDL_GetBasePath(void);

戻り値

(const char *) アプリケーションデータのディレクトリのUTF-8文字列の絶対パス名を戻す. エラーまたはこの機能がないときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数の呼び出し結果はSDLが内部に保存するが, 最初の呼び出しが速いとは限らない. そのことを考慮すること.

Mac OS XとiOSの特別な仕様: アプリケーションが".app"にバンドルされていれば, この関数はリソースディレクトリ(例: MyApp.app/Contents/Resources/)を戻す. この動作はInfo.plistにプロパティを追加して上書きできる. SDL_FILESYSTEM_BASE_DIR_TYPE文字列キーに値を追加すると動作を変えられる.

SDL_FILESYSTEM_BASE_DIR_TYPEプロパティの値(アプリケーションは/Applications/SDLApp/MyApp.appにあるとする):

Androidの特別な仕様: この関数は"./"を戻す. ここから内部ストレージやアセットを使用するためのファイルシステムの操作が可能である.

Nintendo 3DSの特別な仕様: 実行ファイルの外部にリソースを置くことが一般的でないため, この関数はアプリケーションの"romfs"ディレクトリを戻す. このディレクトリは書き込み不可である.

戻されたパスの末尾はパスの区切り文字(Windowsならば'\', 他のほとんどの環境ならば'/')であることが保証されている.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetBasePath - SDL Wiki