C++ 名前付き要件: SharedTimedMutex (C++14以降)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

C++ 名前付き要件

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 型のプロパティ ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType ライブラリワイド BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) アロケータ FunctionObject Callable Predicate BinaryPredicate Compare

コンテナ コンテナ ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   コンテナ要素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) イテレータ LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) ストリームI/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction フォーマッタ BasicFormatter (C++20) フォーマッタ (C++20)

乱数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 並行性 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) Ranges RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多次元ビュー LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) その他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

SharedTimedMutex の要件は、共有ロック所有モードを含むように TimedMutex の要件を拡張します。

要件

• TimedMutex
• SharedMutex

さらに、SharedTimedMutex 型のオブジェクト m は、時限共有操作をサポートします。

• 式 m.try_lock_shared_for(duration) は以下の特性を持ちます。

• アトミック操作として振る舞います。
• duration で指定された期間内にミューテックスの共有所有権を取得しようとします。duration が duration.zero() 以下の場合、待機せずに所有権を取得しようとします (まるで try_lock() のように)。それ以外の場合、この関数はミューテックスが取得されるか、duration で指定された時間が経過するまでブロックします。成功した場合にのみ duration 内で戻りますが、duration 内のある時点で他のスレッドによって所有されていなかったとしても、ミューテックスの取得に失敗する場合があります。いずれの場合でも、ミューテックスが取得された場合は true を、それ以外の場合は false を返します。
• try_lock_shared_for(duration) が成功した場合、同じオブジェクトに対する以前の unlock() 操作は、この操作と同期します (リリース-取得 std::memory_order に相当)。
• 呼び出しスレッドがすでに任意のモードでミューテックスを所有している場合、動作は未定義です。
• 実行中にクロック、タイムポイント、またはデュレーションによって例外がスローされる可能性があります (標準ライブラリが提供するクロック、タイムポイント、およびデュレーションは決してスローしません)。
• 例外がスローされた場合、共有ロックは取得されません。

• 式 m.try_lock_shared_until(time_point) は以下の特性を持ちます。

• アトミック操作として振る舞います。
• time_point までの残り時間内にミューテックスの共有所有権を取得しようとします。time_point がすでに経過している場合、ロックせずに所有権を取得しようとします (まるで try_lock() のように)。それ以外の場合、この関数はミューテックスが取得されるか、time_point で指定された時間が経過するまでブロックします。成功した場合にのみ time_point の前に戻りますが、time_point の前のある時点で他のスレッドによって所有されていなかったとしても、ミューテックスの取得に失敗する場合があります。いずれの場合でも、ミューテックスが取得された場合は true を、それ以外の場合は false を返します。
• try_lock_shared_until(time_point) が成功した場合、同じオブジェクトに対する以前の unlock() 操作は、この操作と同期します (リリース-取得 std::memory_order に相当)。
• 呼び出しスレッドがすでに任意のモードでミューテックスを所有している場合、動作は未定義です。
• 実行中にクロック、タイムポイント、またはデュレーションによって例外がスローされる可能性があります (標準ライブラリが提供するクロック、タイムポイント、およびデュレーションは決してスローしません)。
• 例外がスローされた場合、共有ロックは取得されません。

標準ライブラリ

以下の標準ライブラリ型は SharedTimedMutex の要件を満たします。

shared_timed_mutex (C++14)

共有相互排他機能を提供し、タイムアウト付きのロックを実装する (クラス)

関連項目

• スレッドサポートライブラリ
• Mutex
• TimedMutex
• SharedMutex