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

SDL_CreateSemaphore

新しいセマフォを生成する

構文

SDL_sem* SDL_CreateSemaphore(Uint32 initial_value)

引数

initial_valueセマフォの初期値

戻り値

新しいセマフォを戻す. 失敗のときNULLを戻す. 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);

詳細

この関数は新しいセマフォを生成し, initial_valueの値で初期化する. セマフォの待機操作でアトミック(不可分)にセマフォの値を1減算する. もしセマフォの値が0ならば待機する. 通知操作でアトミックにセマフォの値を1加算し, 待機中のスレッドを再開し, それらが再び待機操作をすることを許可する.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_DestroySemaphore
SDL_SemPost
SDL_SemTryWait
SDL_SemValue
SDL_SemWait
SDL_SemWaitTimeout

SDL Wikiへのリンク

SDL_CreateSemaphore - SDL Wiki