Spec-Zone.ru › C++

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.

Пример

См. также

try_lock_for
попытка блокировки (т.е. взятия владения) связанного TimedLockable мьютекса, возвращает, если мьютекс недоступен в течение указанного времени
(публичный член-функция std::unique_lock<Mutex>)
lock
блокирует связанный мьютекс
(публичный член-функция)
try_lock
пытается заблокировать связанный мьютекс
(публичный член-функция)
try_lock_until
пытается заблокировать связанный мьютекс до указанного момента времени
(публичный член-функция)
unlock
разблокирует связанный мьютекс
(публичный член-функция)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API