std::shared_lock<Mutex>::try_lock_for
template< class Rep, class Period > bool try_lock_for( const std::chrono::duration<Rep,Period>& timeout_duration ); |
(с C++14) |
Попытка заблокировать связанный мьютекс в режиме совместного доступа. Блокируется до истечения указанного timeout_duration, или до получения блокировки, в зависимости от того, что произойдёт раньше. При успешном получении блокировки возвращает true, в противном случае возвращает false. Эффективно вызывает mutex()->try_lock_shared_for(timeout_duration).
Эта функция может блокироваться дольше, чем timeout_duration, из-за задержек планирования или конкуренции за ресурсы.
Стандарт рекомендует использовать стабильные часы для измерения длительности. Если реализация использует системные часы вместо этого, время ожидания может также зависеть от корректировок часов.
std::system_error выбрасывается, если нет связанного мьютекса или если мьютекс уже заблокирован.
Поведение не определено, если Mutex не соответствует требованиям SharedTimedLockable.
Параметры
| timeout_duration | - | максимальное время блокировки |
Возвращаемое значение
true если владение мьютексом было успешно получено, false в противном случае.
Исключения
- Любые исключения, брошенные
mutex()->try_lock_shared_for(timeout_duration). - Если нет связанного мьютекса,
std::system_errorс кодом ошибкиstd::errc::operation_not_permitted. - Если мьютекс уже заблокирован,
std::system_errorс кодом ошибкиstd::errc::resource_deadlock_would_occur.
Пример
См. также
| попытка блокировки (т.е. взятия владения) связанного TimedLockable мьютекса, возвращает, если мьютекс недоступен в течение указанного времени (публичный член-функция std::unique_lock<Mutex>) |
|
| блокирует связанный мьютекс (публичный член-функция) |
|
| пытается заблокировать связанный мьютекс (публичный член-функция) |
|
| пытается заблокировать связанный мьютекс до указанного момента времени (публичный член-функция) |
|
| разблокирует связанный мьютекс (публичный член-функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_for