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) (since C++20)
void atomic_flag_wait( const volatile atomic_flag* object,
                       bool old ) noexcept;
(2) (since C++20)
void atomic_flag_wait_explicit( const atomic_flag* object, 
                                bool old, std::memory_order order ) noexcept;
(3) (since C++20)
void atomic_flag_wait_explicit( const volatile atomic_flag* object,
                                bool old, std::memory_order order ) noexcept;
(4) (since 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/cpp/atomic/atomic_flag_wait

Spec-Zone.ru

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