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

同期プリミティブ

概要

SDLはいくつかのスレッド同期プリミティブ(同期基本機構)を提供している. 次の項目は安全なスレッドの使い方に関する複雑な問題を網羅するものではないが, 少し読めば, その機構が何であるか, なぜそれが有用か, そして正しく使うことがが正しく安全なマルチスレッドプログラミングにとって不可欠であることがわかるだろう.

SDLはデータ型も提供している. SDL_InitState型は, 複数のスレッドが同時に最初にしようとするリソースの初期化/終了処理をただ1つのスレッドが行うことを保証するために使える.

関数

  1. SDL_BroadcastCondition - 条件変数を待つ全てのスレッドを再開する
  2. SDL_CreateCondition - 新しい条件変数を生成する
  3. SDL_CreateMutex - 新しいミューテックスを生成する
  4. SDL_CreateRWLock - 読取/書込ロックを生成する
  5. SDL_CreateSemaphore - 新しいセマフォを生成する
  6. SDL_DestroyCondition - 条件変数を破棄する
  7. SDL_DestroyMutex - SDL_CreateMutex()で生成したミューテックスを破棄する
  8. SDL_DestroyRWLock - SDL_CreateRWLock()で生成した読取/書込ロックを破棄する
  9. SDL_DestroySemaphore - セマフォを破棄する
  10. SDL_GetSemaphoreValue - セマフォの現在の値を得る
  11. SDL_LockMutex - ミューテックスをロックする
  12. SDL_LockRWLockForReading - ブロックせずに読取/書込ロックの読取専用ロックを試みる
  13. SDL_LockRWLockForWriting - ブロックせずに読取/書込ロックの書込ロックを試みる
  14. SDL_SetInitialized - 初期化状態を完了にする
  15. SDL_ShouldInit - 初期化が完了しているかをチェックする
  16. SDL_ShouldQuit - 終了処理が完了しているかをチェックする
  17. SDL_SignalCondition - 条件変数を待つ1つのスレッドを再開する
  18. SDL_SignalSemaphore - セマフォの値を1加算し, 待機中のスレッドを再開する
  19. SDL_TryLockMutex - ブロックせずにミューテックスのロックを試みる
  20. SDL_TryLockRWLockForReading - 読取/書込ロックを読取専用ロックする
  21. SDL_TryLockRWLockForWriting - 読取/書込ロックを書込ロックする
  22. SDL_TryWaitSemaphore - セマフォの値が正であるか調査し, そうならば減算する
  23. SDL_UnlockMutex - ミューテックスのロックを解除する
  24. SDL_UnlockRWLock - 読取/書込ロックをロック解除する
  25. SDL_WaitCondition - 条件変数が通知されるまで待つ
  26. SDL_WaitConditionTimeout - 条件変数が通知されるか指定の時間が経過するまで待つ
  27. SDL_WaitSemaphore - セマフォの値が正になるまで待機し, セマフォの値を減算する
  28. SDL_WaitSemaphoreTimeout - セマフォの値が正になるまで待機し, セマフォの値を減算する(タイムアウト付き)

型

  1. SDL_Condition - 条件変数(条件を満たすまで複数のスレッドをブロックする手段)の型
  2. SDL_Mutex - ミューテックス(スレッド間のアクセスを直列化する手段)の型
  3. SDL_RWLock - 読取専用スレッドは平行して実行できるミューテックスの型
  4. SDL_Semaphore - セマフォ(スレッド間のアクセスをカウントして管理する手段)の型

構造体

  1. SDL_InitState - スレッドセーフな初期化と終了で使用する構造体

列挙体

  1. SDL_InitStatus - SDL_InitState構造体の状態の列挙体

マクロ

  1. SDL_ACQUIRE - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  2. SDL_ACQUIRE_SHARED - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  3. SDL_ACQUIRED_AFTER - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  4. SDL_ACQUIRED_BEFORE - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  5. SDL_ASSERT_CAPABILITY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  6. SDL_ASSERT_SHARED_CAPABILITY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  7. SDL_CAPABILITY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  8. SDL_EXCLUDES - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  9. SDL_GUARDED_BY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  10. SDL_NO_THREAD_SAFETY_ANALYSIS - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  11. SDL_PT_GUARDED_BY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  12. SDL_RELEASE - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  13. SDL_RELEASE_GENERIC - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  14. SDL_RELEASE_SHARED - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  15. SDL_REQUIRES - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  16. SDL_REQUIRES_SHARED - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  17. SDL_RETURN_CAPABILITY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  18. SDL_SCOPED_CAPABILITY - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  19. SDL_THREAD_ANNOTATION_ATTRIBUTE__ - スレッドセーフ属性を有効にする(Clangのみ)
  20. SDL_TRY_ACQUIRE - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ
  21. SDL_TRY_ACQUIRE_SHARED - Clangのスレッドセーフ分析アノテーションのラッパーのマクロ

SDL Wikiへのリンク

SDL3/CategoryMutex - SDL Wiki