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

# SDL_SemTryWait

セマフォの値が正であるか調べ, そうならば減算する

## 構文

`int SDL_SemTryWait(SDL_sem* sem)`

## 引数

sem | セマフォ

## 戻り値

待機操作に成功したとき0, ブロックされたときSDL_MUTEX_TIMEDOUT, 失敗のとき負の数のエラーコードを戻す. 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)) {
            if (SDL_SemTryWait(sem) == 0 && data_available()) {
                get_data_from_queue();
            }
            ... ここで他の処理を行う
        }
    .
    .
    SDL_AtomicSet(&done, 1);
    SDL_SemPost(sem);
    wait_for_threads();
    SDL_DestroySemaphore(sem);

## 詳細

この関数はセマフォsemが正の値であるかチェックし, そうならばアトミックに減算する. セマフォが正の値でなければ, 関数はすぐにSDL_MUTEX_TIMEDOUTを戻す.

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_CreateSemaphore
SDL_DestroySemaphore
SDL_SemPost
SDL_SemValue
SDL_SemWait
SDL_SemWaitTimeout

## SDL Wikiへのリンク

SDL_SemTryWait - SDL Wiki