QMutex Class

int number = 6;

void method1()
{
    number *= 5;
    number /= 4;
}

void method2()
{
    number *= 3;
    number /= 2;
}

// method1()
number *= 5;        // number is now 30
number /= 4;        // number is now 7

// method2()
number *= 3;        // number is now 21
number /= 2;        // number is now 10

// Thread 1 calls method1()
number *= 5;        // number is now 30

// Thread 2 calls method2().
//
// Most likely Thread 1 has been put to sleep by the operating
// system to allow Thread 2 to run.
number *= 3;        // number is now 90
number /= 2;        // number is now 45

// Thread 1 finishes executing.
number /= 4;        // number is now 11, instead of 10

QMutex mutex;
int number = 6;

void method1()
{
    mutex.lock();
    number *= 5;
    number /= 4;
    mutex.unlock();
}

void method2()
{
    mutex.lock();
    number *= 3;
    number /= 2;
    mutex.unlock();
}

멤버 함수 문서

[constexpr noexcept default] QMutex::QMutex()

새로운 뮤텍스를 생성합니다. 이 뮤텍스는 잠금 해제된 상태로 생성됩니다.

[noexcept] QMutex::~QMutex()

뮤텍스를 파기합니다.

[noexcept(...)] void QMutex::lock()

뮤텍스를 잠급니다. 다른 스레드가 이미 뮤텍스를 잠근 상태라면, 이 호출은 해당 스레드가 잠금을 해제할 때까지 차단됩니다.

뮤텍스가 이미 현재 스레드에 의해 잠겨 있는 경우, 이 호출은 절대 반환되지 않아 교착 상태를 유발합니다.

unlock()도 참조하십시오 .

[noexcept(...), since 6.6] bool QMutex::tryLock(QDeadlineTimer timer)

뮤텍스를 잠그려고 시도합니다. 이 함수는 잠금이 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다. 다른 스레드가 뮤텍스를 잠근 상태라면, 이 함수는 ` timer `가 만료되어 뮤텍스가 사용 가능해질 때까지 대기합니다.

잠금을 획득한 경우, 다른 스레드가 뮤텍스를 성공적으로 잠글 수 있으려면 먼저 unlock()를 호출하여 뮤텍스의 잠금을 해제해야 합니다.

이 함수는 Qt 6.6에서 도입되었습니다.

lock() 및 unlock()도 참조하십시오 .

[noexcept(...)] bool QMutex::tryLock(int timeout)

뮤텍스를 잠그려고 시도합니다. 이 함수는 잠금이 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다. 다른 스레드가 뮤텍스를 잠근 상태라면, 이 함수는 뮤텍스가 사용 가능해질 때까지 최대 ` timeout ` 밀리초 동안 대기합니다.

참고: timeout 매개변수로 음수를 전달하는 것은 lock()를 호출하는 것과 동일합니다. 즉, timeout 가 음수인 경우 이 함수는 뮤텍스를 잠글 수 있을 때까지 무한정 대기합니다.

잠금이 확보된 경우, 다른 스레드가 뮤텍스를 성공적으로 잠글 수 있으려면 먼저 unlock()을 사용하여 뮤텍스의 잠금을 해제해야 합니다.

lock() 및 unlock()도 참조하십시오 .

[noexcept] bool QMutex::tryLock()

뮤텍스를 잠그려고 시도합니다. 이 함수는 잠금이 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

잠금이 확보된 경우, 다른 스레드가 뮤텍스를 성공적으로 잠글 수 있으려면 먼저 unlock()을 호출하여 뮤텍스의 잠금을 해제해야 합니다.

lock() 및 unlock()도 참조하십시오 .

[noexcept] bool QMutex::try_lock()

뮤텍스를 잠그려고 시도합니다. 이 함수는 잠금이 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수는 표준 라이브러리의 개념인 ` Lockable`과의 호환성을 위해 제공됩니다. 이는 ` tryLock()`와 동등합니다.

template <typename Rep, typename Period> bool QMutex::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 QMutex::try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)

뮤텍스를 잠그려고 시도합니다. 이 함수는 잠금이 성공하면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다. 다른 스레드가 뮤텍스를 잠근 상태라면, 이 함수는 뮤텍스가 사용 가능해질 때까지 최소한 ` timePoint `까지 대기합니다.

참고: 이미 만료된 timePoint 를 전달하는 것은 try_lock()를 호출하는 것과 동일합니다. 이 동작은 tryLock()와는 다릅니다.

잠금이 획득된 경우, 다른 스레드가 성공적으로 잠금을 획득하려면 먼저 unlock()를 호출하여 뮤텍스를 해제해야 합니다.

lock() 및 unlock()도 참조하십시오 .

[noexcept] void QMutex::unlock()

뮤텍스를 잠금 해제합니다. 뮤텍스를 잠근 스레드와 다른 스레드에서 잠금 해제를 시도하면 오류가 발생합니다. 잠겨 있지 않은 뮤텍스의 잠금을 해제하면 정의되지 않은 동작이 발생합니다.

lock()도 참조하십시오 .