目次 - API(機能別) - 同期プリミティブ - SDL_SemWait

SDL_SemWait

セマフォの値が正になるまで待機し, セマフォの値を減算する

構文

int SDL_SemWait(SDL_sem* sem)

引数

semセマフォ

戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()で詳細を知ることができる.

サンプルコード

SDL_atomic_t done;
SDL_sem *sem;

SDL_AtomicSet(&done, 0);
sem = SDL_CreateSemaphore(0);
.
.
Thread A:
    while (!SDL_AtomicGet(&done)) {
        add_data_to_queue();
        SDL_SemPost(sem);
    }

Thread B:
    while (!SDL_AtomicGet(&done)) {
        SDL_SemWait(sem);
        if (data_available()) {
            get_data_from_queue();
        }
    }
.
.
SDL_AtomicSet(&done, 1);
SDL_SemPost(sem);
wait_for_threads();
SDL_DestroySemaphore(sem);

詳細

セマフォsemの値が正になる, 割り込みが発生する, またはエラーが発生するまでこの関数を呼んだスレッドを停止する. 呼び出しが成功すれば, セマフォの値をアトミックに減算する.

この関数は, SDL_SemWaitTimeout()の待ち時間をSDL_MUTEX_MAXWAITとしたのと同じである.

関連項目(関数)

SDL_CreateSemaphore
SDL_DestroySemaphore
SDL_SemPost
SDL_SemTryWait
SDL_SemValue
SDL_SemWaitTimeout

SDL Wikiへのリンク

SDL_SemWait - SDL Wiki