QReadWriteLock Class

QReadWriteLock lock;

void ReaderThread::run()
{
    //...
    lock.lockForRead();
    read_file();
    lock.unlock();
    //...
}

void WriterThread::run()
{
    //...
    lock.lockForWrite();
    write_file();
    lock.unlock();
    //...
}

멤버 함수 문서

[explicit] QReadWriteLock::QReadWriteLock(QReadWriteLock::RecursionMode recursionMode = NonRecursive)

지정된 recursionMode 에서 QReadWriteLock 객체를 생성합니다.

기본 재귀 모드는 NonRecursive 입니다.

lockForRead(), lockForWrite() 및 RecursionMode도 참조하십시오 .

[noexcept] QReadWriteLock::~QReadWriteLock()

QReadWriteLock 객체를 삭제합니다.

void QReadWriteLock::lockForRead()

잠금을 읽기 전용으로 설정합니다. 다른 스레드가 쓰기 전용으로 잠근 상태라면, 이 함수는 현재 스레드를 차단합니다.

스레드가 이미 쓰기 잠금을 걸고 있는 경우 읽기 잠금을 걸 수 없습니다.

unlock(), lockForWrite(), tryLockForRead()도 참조하십시오 .

void QReadWriteLock::lockForWrite()

잠금을 쓰기 전용으로 잠급니다. 이 함수는 다른 스레드(현재 스레드 포함)가 읽기 또는 쓰기 전용으로 잠근 상태라면 현재 스레드를 차단합니다( QReadWriteLock::Recursive 모드로 잠금이 생성된 경우는 제외).

스레드가 이미 읽기 잠금을 걸고 있는 경우, 쓰기 잠금을 걸 수 없습니다.

unlock(), lockForRead(), tryLockForWrite()도 참조하십시오 .

bool QReadWriteLock::tryLockForRead(int timeout)

읽기용 잠금을 시도합니다. 이 함수는 잠금을 획득한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다. 다른 스레드가 쓰기용 잠금을 획득한 상태라면, 이 함수는 잠금이 해제될 때까지 최대 ` timeout ` 밀리초 동안 대기합니다.

참고: timeout 매개변수로 음수를 전달하는 것은 lockForRead()를 호출하는 것과 동일합니다. 즉, timeout 가 음수일 경우 이 함수는 잠금을 읽기 모드로 획득할 수 있을 때까지 무한정 대기합니다.

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

스레드가 이미 쓰기 용도로 잠금을 획득한 상태라면 읽기 용도로 잠금을 획득할 수 없습니다.

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

[since 6.6] bool QReadWriteLock::tryLockForRead(QDeadlineTimer timeout = {})

읽기 잠금을 시도합니다. 이 함수는 잠금을 획득한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다. 다른 스레드가 쓰기 잠금을 걸고 있는 경우, 이 함수는 ` timeout `가 만료되어 잠금이 사용 가능해질 때까지 대기합니다.

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

스레드가 이미 쓰기 용도로 잠금을 획득한 상태에서는 읽기 용도로 잠금을 획득할 수 없습니다.

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

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

bool QReadWriteLock::tryLockForWrite(int timeout)

쓰기 잠금을 시도합니다. 이 함수는 잠금을 획득한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다. 다른 스레드가 읽기 또는 쓰기 잠금을 걸고 있는 경우, 이 함수는 잠금이 해제될 때까지 최대 ` timeout ` 밀리초 동안 대기합니다.

참고: timeout 로 음수를 전달하는 것은 lockForWrite()을 호출하는 것과 동일합니다. 즉, timeout 가 음수인 경우 이 함수는 쓰기용 잠금을 획득할 수 있을 때까지 무한정 대기합니다.

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

스레드가 이미 읽기 잠금을 설정해 놓은 상태에서는 쓰기 잠금을 설정할 수 없습니다.

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

[since 6.6] bool QReadWriteLock::tryLockForWrite(QDeadlineTimer timeout = {})

쓰기용 잠금을 시도합니다. 이 함수는 잠금을 획득한 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다. 다른 스레드가 읽기 또는 쓰기용으로 잠금을 획득한 경우, 이 함수는 ` timeout `이 만료되어 잠금이 사용 가능해질 때까지 대기합니다.

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

스레드가 이미 읽기 잠금을 걸고 있는 경우, 쓰기 잠금을 걸 수는 없습니다.

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

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

void QReadWriteLock::unlock()

자물쇠를 엽니다.

잠겨 있지 않은 자물쇠를 잠금 해제하려고 하면 오류가 발생하며, 프로그램이 종료됩니다.

lockForRead(), lockForWrite(), tryLockForRead() 및 tryLockForWrite()도 참조하십시오 .