std::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.(since C++20)

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

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

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

Если try_lock_until вызывается потоком, который уже владеет мьютексом, поведение не определено.

Параметры

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

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

Исключения

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

Пример

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

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

См. также