◐ Shell
clean mode source ↗

std::condition_variable::wait_for - cppreference.com

Da cppreference.com.

Questa pagina è stata tradotta in modo automatico dalla versione in ineglese della wiki usando Google Translate.

La traduzione potrebbe contenere errori e termini strani. Muovi il puntatore sopra al testo per vedere la versione originale. Puoi aiutarci a correggere gli gli errori. Per ulteriori istruzioni clicca qui.

Click here for the English version of this page

<metanoindex/>

<tbody> </tbody>

template< class Rep, class Period > std::cv_status wait_for( std::unique_lock<std::mutex>& lock, const std::chrono::duration<Rep, Period>& rel_time);

(1) (dal C++11)

template< class Rep, class Period, class Predicate > bool wait_for( std::unique_lock<std::mutex>& lock, const std::chrono::duration<Rep, Period>& rel_time, Predicate pred);

(2) (dal C++11)

1)

Rilascia atomico lock, blocca il thread corrente di esecuzione, e lo aggiunge alla lista di thread in attesa su *this. Il filo sarà sbloccato quando notify_all() o notify_one() viene eseguito, o quando il timeout rel_time relativa scadenza. Essa può anche essere sbloccato spurio. Quando sbloccato, indipendentemente dal motivo, lock è riacquisito ed esce wait_for(). Se questa funzione termina via eccezionale, lock anche riacquistata.

Original:

Atomically releases lock, blocks the current executing thread, and adds it to the list of threads waiting on *this. The thread will be unblocked when notify_all() or notify_one() is executed, or when the relative timeout rel_time expires. It may also be unblocked spuriously. When unblocked, regardless of the reason, lock is reacquired and wait_for() exits. If this function exits via exception, lock is also reacquired.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

2)

Equivalente a

Original:

Equivalent to

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

while (!pred()) if (wait_for(lock, rel_time) == std::cv_status::timeout) return pred(); return true;

Questo sovraccarico può essere utilizzato per ignorare risvegli spurie.

Original:

This overload may be used to ignore spurious awakenings.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parametri

lock -

un oggetto di std::unique_lock<std::mutex> tipo, che deve essere bloccato dal thread corrente

Original:

an object of type std::unique_lock<std::mutex>, which must be locked by the current thread

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

rel_time -

un oggetto di std::chrono::duration tipo che rappresenta il tempo massimo di attesa di spendere

Original:

an object of type std::chrono::duration representing the maximum time to spend waiting

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

pred - predicate which returns ​false

se l'attesa deve essere continuato

Original:

if the waiting should be continued

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

.

The signature of the predicate function should be equivalent to the following:

bool pred();

Valore di ritorno

1)

std::cv_status::timeout se il timeout relativo specificato da rel_time scaduto, std::cv_status::no_timeout overwise.

Original:

std::cv_status::timeout if the relative timeout specified by rel_time expired, std::cv_status::no_timeout overwise.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

2)

false se il pred predicato restituisce ancora false dopo il timeout rel_time scaduto, altrimenti true.

Original:

false if the predicate pred still evaluates to false after the rel_time timeout expired, otherwise true.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Eccezioni

Può lanciare std::system_error, può anche propagare eccezioni generate dal lock.lock() o lock.unlock().

Original:

May throw std::system_error, may also propagate exceptions thrown by lock.lock() or lock.unlock().

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Note

Chiamare questa funzione se lock.mutex() non è bloccato dal thread corrente è un comportamento indefinito.

Original:

Calling this function if lock.mutex() is not locked by the current thread is undefined behavior.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Chiamare questa funzione se lock.mutex() non è lo stesso mutex come quello utilizzato da tutti gli altri thread che sono attualmente in attesa sulla variabile stessa condizione è un comportamento indefinito.

Original:

Calling this function if lock.mutex() is not the same mutex as the one used by all other threads that are currently waiting on the same condition variable is undefined behavior.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Esempio

#include <iostream>
#include <atomic>
#include <condition_variable>
#include <thread>
#include <chrono>

std::condition_variable cv;
std::mutex cv_m;
std::atomic<int> i = ATOMIC_VAR_INIT(0);

void waits(int idx)
{
    std::unique_lock<std::mutex> lk(cv_m);
    if(cv.wait_for(lk, std::chrono::milliseconds(idx*100), [](){return i == 1;})) 
        std::cerr << "Thread " << idx << " finished waiting. i == " << i << '\n';
    else
        std::cerr << "Thread " << idx << " timed out. i == " << i << '\n';
}

void signals()
{
    std::this_thread::sleep_for(std::chrono::milliseconds(120));
    std::cerr << "Notifying...\n";
    cv.notify_all();
    std::this_thread::sleep_for(std::chrono::milliseconds(100));
    i = 1;
    std::cerr << "Notifying again...\n";
    cv.notify_all();
}

int main()
{
    std::thread t1(waits, 1), t2(waits, 2), t3(waits, 3), t4(signals);
    t1.join(); t2.join(), t3.join(), t4.join();
}

Output:

Thread 1 timed out. i == 0
Notifying...
Thread 2 timed out. i == 0
Notifying again...
Thread 3 finished waiting. i == 1

Vedi anche

blocca il thread corrente fino a quando la variabile di condizione è svegliato

Original:

blocks the current thread until the condition variable is woken up

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.


(metodo pubblico) [modifica]

blocca il thread corrente fino a quando la variabile di condizione è svegliato o fino a che punto nel tempo specificato è stato raggiunto

Original:

blocks the current thread until the condition variable is woken up or until specified time point has been reached

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.


(metodo pubblico) [modifica]