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()도 참조하세요 .