Spec-Zone.ru › C++

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 (часы, временные метки и продолжительности, предоставляемые стандартной библиотекой, никогда не выбрасывают исключения).

Пример

См. также

lock
блокирует мьютекс, блокируется, если мьютекс недоступен
(публичный член-функция)
try_lock
пытается заблокировать мьютекс, возвращает, если мьютекс недоступен
(публичный член-функция)
try_lock_for
пытается заблокировать мьютекс, возвращает, если мьютекс был
недоступен в течение указанного времени ожидания
(публичный член-функция)
unlock
разблокирует мьютекс
(публичный член-функция)
Документация на 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API