Namensräume
Varianten
Aktionen

std::atomic_ref<T>::wait

Von cppreference.com
< cpp‎ | atomic‎ | atomic ref

[Bearbeiten-Vorlage]
 
C++
 
Bibliothek für nebenläufige Programmierung
Threads
(C++11)
(C++20)
(C++17)(C++17)
this_thread Namespace
(C++11)
(C++11)
(C++11)
(C++11)
Kooperatives Beenden
Gegenseitiger Ausschluss
(C++11)
(C++11)
(C++17)
Allgemeines Sperrungsmanagement
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
Bedingungsvariablen
(C++11)
(C++11)
(C++11)
(C++11)
Semaphoren
(C++20)(C++20)
Latches und Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Sichere Wiederherstellung
(C++26)
(C++26)
(C++26)
Hazard Pointer
(C++26)
(C++26)
(C++26)
Atomare Typen
(C++11)
(C++20)
(C++11)
Initialisierung von atomaren Typen
(C++11)(veraltet in C++20)
(C++11)(veraltet in C++20)
(C++11)
Speicherordnung
(C++11)
(C++11)(deprecated in C++26)
(C++11)
(C++11)
Freie Funktionen für atomare Operationen
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
Freie Funktionen für atomare Flags
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::atomic_ref
Memberfunktionen
atomic_ref::wait
(C++26)
Operationen für arithmetische Typen
(außer bool und Zeiger auf Objekte)
Operationen für ganzzahlige Typen
(außer bool und Zeiger auf Objekte)
(C++26)
(C++26)
Operationen für ganzzahlige Typen
(außer bool)
Konstanten
 
void wait( value_type old, std::memory_order order =
                               std::memory_order_seq_cst ) const noexcept;
 (constexpr seit C++26)

Führt atomare Wartevorgänge durch. Verhält sich so, als würde es wiederholt die folgenden Schritte ausführen:

  • Vergleicht die Wertdarstellung von this->load(order) mit der von old.
    • Wenn diese gleich sind, blockiert die Ausführung, bis *this durch notify_one() oder notify_all() benachrichtigt wird oder der Thread aus anderen Gründen (spurious wakeup) aufgeweckt wird.
    • Andernfalls wird zurückgekehrt.

Diese Funktionen geben garantiert nur zurück, wenn sich der Wert geändert hat, auch wenn die zugrunde liegende Implementierung fälschlicherweise entblockiert.

Wenn order nicht std::memory_order_relaxed, std::memory_order_consume, std::memory_order_acquire oder std::memory_order_seq_cst ist, ist das Verhalten undefiniert.

Inhalt

[bearbeiten] Parameter

old - Der Wert, auf den das Objekt der atomic_ref nicht mehr enthält
Reihenfolge - Speicherreihenfolgebeschränkungen, die durchgesetzt werden sollen

[bearbeiten] Hinweise

Diese Form der Änderungsdetektion ist oft effizienter als einfaches Polling oder reine Spinlocks.

Aufgrund des ABA-Problems können transiente Änderungen von old zu einem anderen Wert und zurück zu old möglicherweise übersehen werden und nicht zu einer Entsperrung führen.

Der Vergleich ist bitweise (ähnlich wie bei std::memcmp); es wird kein Vergleichsoperator verwendet. Auffüllbits, die nie an der Wertrepräsentation eines Objekts teilnehmen, werden ignoriert.

[bearbeiten] Beispiel

Dieser Abschnitt ist unvollständig
Grund: kein Beispiel

[bearbeiten] Siehe auch

 benachrichtigt mindestens einen Thread, der auf das atomare Objekt wartet
(public member function) [edit]
 benachrichtigt alle Threads, die auf das atomare Objekt warten
(public member function) [edit]
(C++20)
 benachrichtigt einen Thread, der in atomic_wait blockiert ist
(Funktions-Template) [bearbeiten]
(C++20)
 benachrichtigt alle Threads, die in atomic_wait blockiert sind
(Funktions-Template) [bearbeiten]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/atomic/atomic_ref/wait&oldid=116003"