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