std::recursive_timed_mutex::try_lock_until

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

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

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

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

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

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

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

Поток может многократно вызывать try_lock_until для рекурсивного мьютекса. Успешные вызовы try_lock_until увеличивают счётчик владения: мьютекс будет разблокирован только после того, как поток сделает соответствующее количество вызовов unlock.

Максимальное количество уровней владения не определено. Вызов try_lock_until вернёт false в случае превышения этого числа.

Параметры

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

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

Исключения

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

Пример

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также