Spec-Zone.ru › C++

std::atomic_flag_wait, std::atomic_flag_wait_explicit

Определено в заголовке <atomic>
void atomic_flag_wait( const atomic_flag* object, bool old ) noexcept;
(1) (с C++20)
void atomic_flag_wait( const volatile atomic_flag* object,
                       bool old ) noexcept;
(2) (с C++20)
void atomic_flag_wait_explicit( const atomic_flag* object, 
                                bool old, std::memory_order order ) noexcept;
(3) (с C++20)
void atomic_flag_wait_explicit( const volatile atomic_flag* object,
                                bool old, std::memory_order order ) noexcept;
(4) (с C++20)

Выполняет атомарные операции ожидания.

Сравнивает object->test(std::memory_order_seq_cst) или object->test(order) со значением old, и если они равны, то блокируется до тех пор, пока *object не будет уведомлен функцией std::atomic_flag::notify_one() или std::atomic_flag::notify_all() (или поток разблокируется случайным образом). Это повторяется до тех пор, пока значения не окажутся неравными.

1,2) Порядок синхронизации памяти — std::memory_order_seq_cst.
3,4) Порядок синхронизации памяти — order.
Если order является одним из значений std::memory_order_release и std::memory_order_acq_rel, поведение не определено.

Эти функции гарантированно возвращают результат только если значение изменилось, даже если реализация разблокирует поток случайным образом.

Параметры

object - указатель на атомарную метку, для которой выполняется проверка и ожидание
old - значение, с которым сравнивается атомарная метка
order - порядок синхронизации памяти

Возвращаемое значение

(нет)

Примечания

Этот способ обнаружения изменений часто более эффективен, чем простое опробование или чистые блокировки.

Из-за проблемы ABA, временные изменения значения с old на другое значение и обратно в old могут быть пропущены, и разблокировка не произойдёт.

Пример

См. также

notify_one
(C++20)
уведомляет хотя бы один поток, ожидающий атомарного объекта
(публичный член-функция std::atomic_flag)
notify_all
(C++20)
уведомляет все потоки, заблокированные в ожидании атомарного объекта
(публичный член-функция std::atomic_flag)
atomic_flag_notify_one
(C++20)
уведомляет поток, заблокированный в atomic_flag_wait
(функция)
atomic_flag_notify_all
(C++20)
уведомляет все потоки, заблокированные в atomic_flag_wait
(функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/atomic/atomic_flag_wait

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API