D.5.4. Класс std::recursive_timed_mutex
Класс std::recursive_timed_mutex предоставляет поддержку блокировок с таймаутами сверх базовых средств взаимного исключения и синхронизации, предоставляемых классом std::recursive_mutex. Перед тем как обращаться к данным, защищаемым мьютексом, этот мьютекс необходимо захватить (или заблокировать), вызвав функцию lock(), try_lock(), try_lock_for() или try_lock_until(). Если мьютекс уже захвачен другим потоком, то функция try_lock() вернет ошибку, функция lock() приостановит выполнение потока до получения мьютекса, а функции try_lock_for() и try_lock_until() приостановят выполнение потока до получения мьютекса или истечения таймаута. Закончив операции над разделяемыми данными, поток должен вызвать функцию unlock() (вне зависимости от того, какой функцией мьютекс был захвачен), чтобы освободить мьютекс и дать другим потокам возможность захватить его.
Этот мьютекс называется рекурсивным, потому что поток, удерживающий мьютекс типа std::recursive_timed_mutex, может снова захватить его любой функцией захвата. Никакой другой поток не сможет захватить этот мьютекс, пока владеющий им поток не вызовет функцию unlock столько раз, сколько было успешных вызовов функций захвата.
Экземпляр std::recursive_timed_mutex удовлетворяет требованиям концепции TimedLockable.
Определение класса
class recursive_timed_mutex {
public:
recursive_timed_mutex(recursive_timed_mutex const&)=delete;
recursive_timed_mutex& operator=(
recursive_timed_mutex const&)=delete;
recursive_timed_mutex();
~recursive_timed_mutex();
void lock();
void unlock();
bool try_lock() noexcept;
template<typename Rep, typename Period>
bool try_lock_for(
std::chrono::duration<Rep, Period> const& relative_time);
template<typename Clock, typename Duration>
bool try_lock_until(
std::chrono::time_point<Clock, Duration> const& absolute_time);
};
STD::RECURSIVE_TIMED_MUTEX , КОНСТРУКТОР ПО УМОЛЧАНИЮ
Конструирует объект std::recursive_timed_mutex.
Объявление
recursive_timed_mutex();
Результат
Конструирует экземпляр std::recursive_timed_mutex.
Постусловия
Вновь сконструированный объект std::recursive_timed_mutex первоначально не захвачен.
Исключения
Исключение типа std::system_error, если не удалось создать экземпляр std::recursive_timed_mutex.
STD::RECURSIVE_TIMED_MUTEX , ДЕСТРУКТОР
Уничтожает объект std::recursive_timed_mutex.
Объявление
~recursive_timed_mutex();
Предусловия
Объект *this не должен быть захвачен.
Результат
Уничтожает *this.
Исключения
Нет.
STD::RECURSIVE_TIMED_MUTEX::LOCK , ФУНКЦИЯ-ЧЛЕН
Захватывает объект std::recursive_timed_mutex для текущего потока.
Объявление
void lock();
Результат
Блокирует текущий поток, пока мьютекс *this не будет захвачен.
Постусловия
*this захвачен текущим потоком. Если вызывающий поток уже удерживал *this, то счетчик захватов увеличивается на единицу.
Исключения
Исключение типа std::system_error в случае ошибки.
STD::RECURSIVE_TIMED_MUTEX::TRY_LOCK , ФУНКЦИЯ-ЧЛЕН
Пытается захватить объект std::recursive_timed_mutex для текущего потока.
Объявление
bool try_lock() noexcept;
Результат
Пытается захватить объект std::recursive_timed_mutex для текущего потока без блокирования.
Возвращаемое значение
true, если вызывающий поток захватил мьютекс, иначе false.
Постусловия
*this захвачен вызывающим потоком, если функция вернула true.
Исключения
Нет.
Примечание. Если вызывающий поток уже удерживал *this, то функция возвращает true, и счетчик захватов *this текущим потоком увеличивается на единицу. Если текущий поток не удерживал *this, то функция может не захватить мьютекс (и вернуть false), даже если никакой другой поток не удерживает *this.
STD::RECURSIVE_TIMED_MUTEX::TRY_LOCK_FOR , ФУНКЦИЯ-ЧЛЕН
Пытается захватить объект std::recursive_timed_mutex для текущего потока.
Объявление
template<typename Rep, typename Period>
bool try_lock_for(
std::chrono::duration<Rep, Period> const& relative_time);
Результат
Пытается захватить объект std::recursive_timed_mutex для текущего потока в течение времени, заданного аргументом relative_time. Если relative_time.count() равно нулю или отрицательно, то функция возвращается немедленно, как если бы это был вызов try_lock(). В противном случае вызывающий поток приостанавливается до получения мьютекса или до истечения времени, заданного аргументом relative_time.
Возвращаемое значение
true, если вызывающий поток захватил мьютекс, иначе false.
Постусловия
*this захвачен вызывающим потоком, если функция вернула true.
Исключения
Нет.
Примечание. Если вызывающий поток уже удерживал *this, то функция возвращает true, и счетчик захватов *this текущим потоком увеличивается на единицу. Если текущий поток не удерживал *this, то функция может не захватить мьютекс (и вернуть false), даже если никакой другой поток не удерживает *this. Поток может быть блокирован дольше, чем указано. Если возможно, истекшее время измеряется по стабильным часам.
STD::RECURSIVE_TIMED_MUTEX::TRY_LOCK_UNTIL , ФУНКЦИЯ-ЧЛЕН
Пытается захватить объект std::recursive_timed_mutex для текущего потока.
Объявление
template<typename Clock, typename Duration>
bool try_lock_until(
std::chrono::time_point<Clock, Duration> const& absolute_time);
Результат
Пытается захватить объект std::recursive_timed_mutex для текущего потока, пока не наступит момент времени, заданный аргументом absolute_time. Если в момент вызова absolute_time <= Clock::now(), то функция возвращается немедленно, как если бы это был вызов try_lock(). В противном случае вызывающий поток приостанавливается до получения мьютекса или до наступления момента времени, большего или равного absolute_time.
Возвращаемое значение
true, если вызывающий поток захватил мьютекс, иначе false.
Постусловия
*this захвачен вызывающим потоком, если функция вернула true.
Исключения
Нет.
Примечание. Если вызывающий поток уже удерживал *this, то функция возвращает true, и счетчик захватов *this текущим потоком увеличивается на единицу. Если текущий поток не удерживал *this, то функция может не захватить мьютекс (и вернуть false), даже если никакой другой поток не удерживает *this. Не дается никаких гарантий относительно того, сколько времени будет блокирован вызывающий поток. Гарантируется лишь, что если функция вернула false, то значение, возвращенное Clock::now(), больше или равно absolute_time в точке, где поток разблокировался.
STD::RECURSIVE_TIMED_MUTEX::UNLOCK , ФУНКЦИЯ-ЧЛЕН
Освобождает объект std::recursive_timed_mutex, удерживаемый текущим потоком.
Объявление
void unlock();
Предусловия
Вызывающий поток должен удерживать мьютекс *this.
Результат
Освобождает мьютекс *this, удерживаемый текущим потоком. Если это последний захват *this данным потоком, и другие потоки были блокированы в ожидании *this, то один из них разблокируется.
Постусловия
Количество захватов *this вызывающим потоком, уменьшается на единицу.
Исключения
Нет.