void SDL_WaitThread(SDL_Thread *thread, int *status);
| SDL_Thread * | thread | SDL_CreateThread()で開始されたスレッドのSDL_Threadポインタ |
| int * | status | スレッド関数がreturnで戻した値の代入先へのポインタ. スレッドが自身で消滅した(デタッチdetach)した, または有効でないとき-1が代入される. NULLも可 |
デタッチされていないスレッドは, この関数で後処理するまで残る. これを行わないとリソースリークを引き起こす.
この関数でスレッドが消滅すると, そのSDL_Threadは使えなくなるので再び参照してはならない. 1つのスレッドの終了をSDL_WaitThread()で待つのは, 別の1つのスレッドのみにしたほうがよい.
スレッド関数の戻り値は, statusがNULLでなければ, statusの領域に書き込まれる.
デタッチされたスレッドに対してSDL_WaitThread()を呼んではならない. SDL_WaitThread()かSDL_DetachThread()のどちらかであり, 両方を使ってはならない. さもなくば, その動作は未定義のものになる.
引数をNULLとしても安全である. その場合は無視される.
threadポインタはこの関数で解放されるため, その後は使えないので注意すること.