std::shared_lock<Mutex>::try_lock_until
template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock,Duration>& timeout_time ); | (начиная с C++14) |
Пытается заблокировать связанный мьютекс в режиме совместного доступа. Блокирует поток до наступления указанного timeout_time или до получения блокировки — в зависимости от того, что произойдёт раньше. Если блокировка успешно получена, возвращает true, в противном случае возвращает false. Может блокировать поток дольше, чем до наступления timeout_time.
Фактически вызывает mutex()->try_lock_shared_until(timeout_time).
Выбрасывается std::system_error, если связанный мьютекс отсутствует или уже заблокирован.
Clock должен соответствовать требованиям Clock. Поведение не определено, если Mutex не соответствует требованиям SharedTimedLockable. Программа некорректна, если std::chrono::is_clock_v<Clock> является false.(начиная с C++20)
Параметры
| timeout_time | - | максимальный момент времени ожидания блокировки |
Возвращаемое значение
true, если владение мьютексом успешно получено, в противном случае — false.
Исключения
- Любые исключения, выброшенные
mutex()->try_lock_shared_for(timeout_time). - Если связанный мьютекс отсутствует,
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/cpp/thread/shared_lock/try_lock_until