std::condition_variable:: wait_until

wait_until 는 현재 스레드가 조건 변수가 통지될 때까지, 주어진 시간 포인트에 도달할 때까지, 또는 가짜 깨어남이 발생할 때까지 블록되도록 합니다. pred 는 가짜 깨어남을 감지하기 위해 선택적으로 제공될 수 있습니다.

wait_until 이 반환된 직후, lock. owns_lock ( ) 는 true 이며, lock. mutex ( ) 는 호출 스레드에 의해 잠겨 있습니다. 이러한 사후 조건이 충족될 수 없는 경우 ^[1] , std::terminate 를 호출합니다.

다음 조건 중 하나라도 충족되면, 동작은 정의되지 않습니다:

• lock. owns_lock ( ) 이 false 인 경우.
• lock. mutex ( ) 이 호출 스레드에 의해 잠겨 있지 않은 경우.
• 다른 스레드들도 * this 를 기다리고 있을 때, lock. mutex ( ) 이 해당 스레드들이 * this 에서 호출한 대기 함수들( wait , wait_for 및 wait_until )에 의해 잠금 해제된 뮤텍스와 다른 경우.

1. ↑ 뮤텍스를 재잠금하는 과정에서 예외가 발생할 경우 이런 상황이 발생할 수 있습니다.

매개변수

반환값

예외

참고 사항

표준은 abs_time 에 연결된 클럭을 사용하여 시간을 측정할 것을 권장합니다; 해당 클럭이 단조 클럭일 필요는 없습니다. 클럭이 불연속적으로 조정되는 경우 이 함수의 동작에 대한 보장은 없지만, 기존 구현들은 abs_time 을 Clock 에서 std::chrono::system_clock 으로 변환하고 POSIX pthread_cond_timedwait 에 위임하여 시스템 클럭에 대한 조정은 준수하지만 사용자가 제공한 Clock 에 대한 조정은 준수하지 않습니다. 어떤 경우든, 이 함수는 스케줄링 또는 자원 경합 지연으로 인해 abs_time 이 경과한 이후까지 더 오래 대기할 수도 있습니다.

사용 중인 클록이 std::chrono::steady_clock 또는 다른 모노토닉 클록이라 하더라도, 시스템 클록 조정이 가짜 웨이크업(spurious wakeup)을 유발할 수 있습니다.

notify_one() / notify_all() 의 효과와 wait() / wait_for() / wait_until() 의 세 가지 원자적 부분(잠금 해제+대기, 깨어남, 잠금)은 수정 순서 로 볼 수 있는 단일 전체 순서로 발생합니다: 이 순서는 해당 개별 조건 변수에 특정됩니다. 이로 인해 notify_one() 이 지연되어 notify_one() 호출 직후 대기를 시작한 스레드의 차단을 해제하는 것과 같은 상황이 발생하는 것이 불가능합니다.

예제

#include <chrono>
#include <condition_variable>
#include <iostream>
#include <thread>
std::condition_variable cv;
std::mutex cv_m; // 이 뮤텍스는 세 가지 목적으로 사용됩니다:
                 // 1) i에 대한 접근 동기화
                 // 2) std::cerr에 대한 접근 동기화
                 // 3) 조건 변수 cv를 위한 용도
int i = 0;
void waits()
{
    std::unique_lock<std::mutex> lk(cv_m);
    std::cerr << "Waiting... \n";
    cv.wait(lk, []{ return i == 1; });
    std::cerr << "...finished waiting. i == 1\n";
}
void signals()
{
    std::this_thread::sleep_for(std::chrono::seconds(1));
    {
        std::lock_guard<std::mutex> lk(cv_m);
        std::cerr << "Notifying...\n";
    }
    cv.notify_all();
    std::this_thread::sleep_for(std::chrono::seconds(1));
    {
        std::lock_guard<std::mutex> lk(cv_m);
        i = 1;
        std::cerr << "Notifying again...\n";
    }
    cv.notify_all();
}
int main()
{
    std::thread t1(waits), t2(waits), t3(waits), t4(signals);
    t1.join(); 
    t2.join(); 
    t3.join();
    t4.join();
}

Waiting...
Waiting...
Waiting...
Notifying...
Notifying again...
...finished waiting. i == 1
...finished waiting. i == 1
...finished waiting. i == 1

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목