TheTimedMutex requirements extend theTimedLockable requirements to include inter-thread synchronization.

[edit]Requirements

• TimedLockable
• Mutex

Additionally, for an objectm ofTimedMutex type:

• The expressionm.try_lock_for(duration) has the following properties

• Behaves as an atomic operation.
• Attempts to obtain exclusive ownership of the mutex within the duration specified byduration. Ifduration is less or equalduration.zero(), attempts to obtain the ownership without blocking (as if bytry_lock()). Otherwise, this function blocks until the mutex is acquired or until the time specified byduration passes. It returns withinduration only if it succeeds, but it is allowed to fail to acquire the mutex even if at some point in time duringduration it was not owned by another thread. In any case, it returnstrue if the mutex was acquired andfalse otherwise.
• Iftry_lock_for(duration) succeeds, priorunlock() operations on the same objectsynchronize-with this operation (equivalent to release-acquirestd::memory_order).
• The behavior is undefined if the calling thread already owns the mutex (except if m isstd::recursive_timed_mutex).
• An exception may be thrown by clock, time point, or duration during the execution (clocks, time points, and durations provided by the standard library never throw).

• The expressionm.try_lock_until(time_point) has the following properties

• Behaves as an atomic operation.
• Attempts to obtain exclusive ownership of the mutex within the time left untiltime_point. Iftime_point already passed, attempts to obtain the ownership without blocking (as if bytry_lock()). Otherwise, this function blocks until the mutex is acquired or until the time specified bytime_point passes. It returns beforetime_point only if it succeeds, but it is allowed to fail to acquire the mutex even if at some point in time beforetime_point it was not owned by another thread. In any case, it returnstrue if the mutex was acquired andfalse otherwise.
• Iftry_lock_until(time_point) succeeds, priorunlock() operations on the same objectsynchronize-with this operation (equivalent to release-acquirestd::memory_order).
• The behavior is undefined if the calling thread already owns the mutex (except if m isstd::recursive_timed_mutex).
• An exception may be thrown by clock, time point, or duration during the execution (clocks, time points, and durations provided by the standard library never throw).

[edit]Standard library

The following standard library types satisfyTimedMutex requirements:

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• Thread support library
• TimedLockable
• Mutex

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文