QRecursiveMutex 类

成员函数文档

[constexpr noexcept] QRecursiveMutex::QRecursiveMutex()

构造一个新的递归互斥锁。互斥锁以解锁状态创建。

另请参阅：lock() 和 unlock()。

[noexcept] QRecursiveMutex::~QRecursiveMutex()

销毁互斥锁。

[noexcept] void QRecursiveMutex::lock()

锁定互斥锁。如果另一个线程已锁定互斥锁，则此调用将阻塞，直到该线程将其解锁。

从同一线程多次调用此函数锁定同一互斥锁是允许的。

另请参阅解锁。

[noexcept] bool QRecursiveMutex::tryLock(int timeout)

尝试锁定互斥锁。如果成功获得锁，该函数返回 true，否则返回 false。如果另一个线程已锁定互斥锁，此函数将等待最多 timeout 毫秒直至互斥锁可用。

注意：传递负数作为 timeout 等同于调用 lock()，即如果 timeout 为负，此函数将无限期地等待互斥锁可用。

如果成功获得锁，必须在其他线程成功锁定它之前使用 unlock() 将互斥锁解锁。

从同一线程多次调用此函数锁定同一互斥锁是允许的。

另请参阅：lock() 和 unlock()。

[noexcept，自 6.6 版起] bool QRecursiveMutex::tryLock(QDeadlineTimer timeout = {})

尝试锁定互斥锁。如果成功获得锁，该函数返回 true，否则返回 false。如果另一个线程已锁定互斥锁，此函数将等待，直到 timeout 过期，互斥锁才可用。

如果成功获得锁，必须在其他线程成功锁定它之前使用 unlock() 将互斥锁解锁。

从同一线程多次调用此函数锁定同一互斥锁是允许的。

此功能自 Qt 6.6 版开始引入。

另请参阅：lock() 和 unlock()。

[noexcept] bool QRecursiveMutex::try_lock()

尝试锁定互斥锁。如果成功获得锁，该函数返回 true，否则返回 false。

此函数提供与标准库概念 Lockable 相兼容。它等同于 tryLock。

template <typename Rep, typename Period> bool QRecursiveMutex::try_lock_for(std::chrono::duration<Rep, Period> duration)

尝试锁定互斥锁。如果成功获得锁，该函数返回 true，否则返回 false。如果另一个线程已锁定互斥锁，此函数将等待至少 duration 直至互斥锁可用。

注意：传递负持续时间作为 duration 等同于调用 try_lock。此行为与 tryLock 不同。

如果成功获得锁，必须在其他线程成功锁定它之前使用 unlock() 将互斥锁解锁。

从同一线程多次调用此函数锁定同一互斥锁是允许的。

另请参阅：lock() 和 unlock()。

template <typename Clock, typename Duration> bool QRecursiveMutex::try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)

尝试加锁互斥量。如果成功获得锁，此函数返回true，否则返回false。如果另一个线程已经锁定互斥量，此函数将等待直到timePoint，直到互斥量变得可用。

注意：传递一个已经过去的timePoint等于调用try_lock()。这种行为与tryLock()不同。

如果成功获得锁，必须在其他线程成功锁定它之前使用 unlock() 将互斥锁解锁。

从同一线程多次调用此函数锁定同一互斥锁是允许的。

另请参阅：lock() 和 unlock()。

[noexcept] void QRecursiveMutex::unlock()

解锁互斥量。如果在加锁互斥量的不同线程中尝试解锁会返回错误。尝试解锁未加锁的互斥量会导致未定义行为。

另请参阅lock()。