Tries to lock (i.e., takes ownership of) the associated mutex. Blocks until specifiedtimeout_duration has elapsed or the lock is acquired, whichever comes first. On successful lock acquisition returnstrue, otherwise returnsfalse. Effectively callsmutex()->try_lock_for(timeout_duration).

This function may block for longer thantimeout_duration due to scheduling or resource contention delays.

The standard recommends that a steady clock is used to measure the duration. If an implementation uses a system clock instead, the wait time may also be sensitive to clock adjustments.

std::system_error is thrown if there is no associated mutex or if the mutex is already locked by this std::unique_lock.

[edit]Parameters

[edit]Return value

true if the ownership of the mutex has been acquired successfully,false otherwise.

[edit]Exceptions

• Any exceptions thrown bymutex()->try_lock_for(timeout_duration).

• If there is no associated mutex,std::system_error with an error code ofstd::errc::operation_not_permitted.

• If the mutex is already locked,std::system_error with an error code ofstd::errc::resource_deadlock_would_occur.

[edit]Example

[edit]See also

• In other languages

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