bool SDL_SetPointerPropertyWithCleanup(SDL_PropertiesID props, const char *name, void *value, SDL_CleanupPropertyCallback cleanup, void *userdata);
| SDL_PropertiesID | props | 設定するプロパティグループ |
| const char * | name | 設定するプロパティの名前 |
| void * | value | プロパティの新しい値. NULLのときプロパティを削除する |
| SDL_CleanupPropertyCallback | cleanup | プロパティが削除されたとき呼ばれる関数. 終了処理関数が不要のときNULL |
| void * | userdata | 終了処理関数に渡すポインタ |
(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.
終了処理関数は, どのような理由でもプロパティの設定に失敗したときも呼ばれる.
整数型, ブール型, 文字列型などの基本的なデータ型を単に設定したい場合は, 代わりにSDL_SetNumberProperty, SDL_SetBooleanProperty, SDL_SetStringPropertyを使うこと. これらの関数はアプリケーションに代わって終了処理を行う. この関数は, より複雑なカスタムデータのためにのみ存在する.
この関数はどのスレッドからも安全に呼べる.
SDL 3.2.0以降