std::shared_timed_mutex::try_lock_shared_until

template< class Clock, class Duration >
bool try_lock_shared_until( const std::chrono::time_point<Clock,Duration>& timeout_time );

Пытается заблокировать мьютекс в режиме совместного доступа. Блокируется до тех пор, пока не будет достигнуто указанное timeout_time, или блокировка будет приобретена, что произойдет раньше. При успешном приобретении блокировки возвращает true, в противном случае возвращает false.

Если timeout_time уже прошло, эта функция ведет себя как try_lock_shared().

Clock должно соответствовать требованиям Clock. Программа некорректна, если std::chrono::is_clock_v<Clock> является false.(с C++20)

Стандарт рекомендует использовать связанный с timeout_time часовой механизм, в таком случае корректировки часового механизма могут быть учтены. Таким образом, продолжительность блокировки может быть больше или меньше, чем timeout_time - Clock::now() в момент вызова, в зависимости от направления корректировки и того, учитывается ли она реализацией. Функция также может блокироваться до тех пор, пока не будет достигнуто timeout_time, из-за задержек планирования процессов или конкуренции за ресурсы.

Как и в случае с try_lock_shared(), эта функция может случайным образом завершиться неудачно и вернуть false даже если мьютекс не был заблокирован ни одной другой нитью в какой-то момент до timeout_time.

Предыдущая unlock() операция над тем же мьютексом синхронизируется с (как определено в std::memory_order) этой операцией, если она возвращает true.

Если try_lock_shared_until вызывается нитью, которая уже владеет mutex в любом режиме (совместном или исключительном), поведение не определено.

Параметры

Возвращаемое значение

true если владение совместной блокировкой было успешно приобретено, в противном случае false.

Исключения

Любое исключение, сгенерированное часовым механизмом, time_point или duration во время выполнения (часовые механизмы, временные метки и продолжительности, предоставляемые стандартной библиотекой, никогда не генерируют исключения).

Пример

См. также