std::atomic_flag::wait

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека атомарных операций

Типы

atomic (C++11)

atomic_ref (C++20)

Функции

atomic_storeatomic_store_explicit (C++11)(C++11)

atomic_loadatomic_load_explicit (C++11)(C++11)

atomic_exchangeatomic_exchange_explicit (C++11)(C++11)

atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11)

atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11)

atomic_fetch_subatomic_fetch_sub_explicit (C++11)(C++11)

atomic_fetch_andatomic_fetch_and_explicit (C++11)(C++11)

atomic_fetch_oratomic_fetch_or_explicit (C++11)(C++11)

atomic_fetch_xoratomic_fetch_xor_explicit (C++11)(C++11)

atomic_is_lock_free (C++11)

atomic_waitatomic_wait_explicit (C++20)(C++20)

atomic_notify_one (C++20)

atomic_notify_all (C++20)

Атомарные флаги

atomic_flag (C++11)

atomic_flag_test_and_setatomic_flag_test_and_set_explicit (C++11)(C++11)

atomic_flag_clearatomic_flag_clear_explicit (C++11)(C++11)

atomic_flag_testatomic_flag_test_explicit (C++20)(C++20)

atomic_flag_waitatomic_flag_wait_explicit (C++20)(C++20)

atomic_flag_notify_one (C++20)

atomic_flag_notify_all (C++20)

Инициализация

atomic_init (C++11)(устарело в C++20)

ATOMIC_VAR_INIT (C++11)(устарело в C++20)

ATOMIC_FLAG_INIT (C++11)(устарело в C++20)

Упорядочивание доступа к памяти

memory_order (C++11)

kill_dependency (C++11)

atomic_thread_fence (C++11)

atomic_signal_fence (C++11)

 

std::atomic_flag

Функции-элементы

atomic_flag::atomic_flag

atomic_flag::operator=

atomic_flag::clear

atomic_flag::test_and_set

atomic_flag::test (C++20)

atomic_flag::wait (C++20)

atomic_flag::notify_one (C++20)

atomic_flag::notify_all (C++20)

 

<tbody> </tbody>

void wait( bool old, std::memory_order order = {{#pad:|4}} std::memory_order::seq_cst ) const noexcept;	(1)	(начиная с C++20)
void wait( bool old, std::memory_order order = {{#pad:|4}} std::memory_order::seq_cst ) const volatile noexcept;	(2)	(начиная с C++20)

Выполняет атомарные операции ожидания. Ведёт себя так, как если бы неоднократно выполнялись следующие шаги:

• Сравнивает this->test(order) с old.
  • Если они равны, то блокируется до тех пор, пока *this не будет уведомлён notify_one() или notify_all(), или пока поток не будет ложно разблокирован.
  • Иначе, возвращается.

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

Если order является одним из std::memory_order::release и std::memory_order::acq_rel, поведение не определено.

Параметры

old	—	значение для проверки atomic_flag, которое объект больше не содержит
order	—	порядок синхронизации памяти для этой операции

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

(нет)

Примечание

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

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

Смотрите также

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