std::condition_variable_any:: wait_until

wait_until 는 조건 변수가 통지될 때까지, 주어진 시간이 경과할 때까지, 또는 잘못된 깨어남이 발생할 때까지 현재 스레드를 차단합니다. pred 는 선택적으로 제공되어 잘못된 깨어남을 감지하는 데 사용될 수 있습니다.

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

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

매개변수

반환값

예외

참고 사항

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

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

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_any 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++ 표준에 소급 적용되었습니다.

참고 항목