std::shared_timed_mutex::try_lock_until
template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time ); | (since C++14) |
Пытается захватить мьютекс. Блокируется до тех пор, пока не будет достигнута указанная timeout_time (таймаут) или не будет захвачен замок (владеет мьютексом), что произойдет первым. При успешном захвате замка возвращает true, в противном случае возвращает false.
Если timeout_time уже прошло, эта функция ведет себя как try_lock().
Clock должно удовлетворять требованиям Clock. Программа некорректна, если std::chrono::is_clock_v<Clock> является false.(since C++20)
Стандарт рекомендует использовать часы, привязанные к timeout_time, в этом случае корректировки часов могут быть учтены. Таким образом, продолжительность блокировки может быть больше или меньше timeout_time - Clock::now() в момент вызова, в зависимости от направления корректировки и того, учтена ли она реализацией. Функция также может блокироваться до тех пор, пока не будет достигнуто timeout_time из-за задержек планирования процессов или конфликтов ресурсов.
Как и в случае с try_lock(), этой функции разрешено ошибаться и возвращать false даже если мьютекс не был захвачен ни одним другим потоком в какой-то момент до timeout_time.
Предыдущая unlock() операция над тем же мьютексом синхронизируется (как определено в std::memory_order) с этой операцией, если она возвращает true.
Если try_lock_until вызывается потоком, который уже владеет мьютексом в любом режиме (совместном или эксклюзивном), поведение не определено.
Параметры
| timeout_time | - | максимальная точка во времени для блокировки |
Возвращаемое значение
true если замок был успешно захвачен, в противном случае false.
Исключения
Любое исключение, брошенное timeout_time (часы, временные метки и продолжительности, предоставляемые стандартной библиотекой, никогда не выбрасывают исключения).
Пример
См. также
| блокирует мьютекс, блокируется, если мьютекс недоступен (публичный член-функция) |
|
| пытается заблокировать мьютекс, возвращает, если мьютекс недоступен (публичный член-функция) |
|
| пытается заблокировать мьютекс, возвращает, если мьютекс был недоступен в течение указанного времени ожидания (публичный член-функция) |
|
| разблокирует мьютекс (публичный член-функция) |
|
Документация на C для mtx_timedlock |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/thread/shared_timed_mutex/try_lock_until