std::stop_callback

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

并发支持库

线程 thread (C++11) jthread (C++20) stop_token (C++20) stop_source (C++20) stop_callback (C++20) hardware_destructive_interference_sizehardware_constructive_interference_size (C++17)(C++17) this_thread 命名空间 get_id (C++11) yield (C++11) sleep_for (C++11) sleep_until (C++11) 原子类型 atomic (C++11) atomic_ref (C++20) atomic_flag (C++11) 原子类型的初始化 atomic_init (C++11)(C++20 中弃用) ATOMIC_VAR_INIT (C++11)(C++20 中弃用) ATOMIC_FLAG_INIT (C++11) 原子操作的自由函数 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_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) 内存序 memory_order (C++11) kill_dependency (C++11) atomic_thread_fence (C++11) atomic_signal_fence (C++11) 互斥 mutex (C++11) recursive_mutex (C++11) shared_mutex (C++17) timed_mutex (C++11) recursive_timed_mutex (C++11) shared_timed_mutex (C++14) 通用锁管理 lock_guard (C++11) scoped_lock (C++17) unique_lock (C++11) shared_lock (C++14) defer_lock_ttry_to_lock_tadopt_lock_t (C++11)(C++11)(C++11) lock (C++11) try_lock (C++11) defer_locktry_to_lockadopt_lock (C++11)(C++11)(C++11) once_flag (C++11) call_once (C++11) 条件变量 condition_variable (C++11) condition_variable_any (C++11) notify_all_at_thread_exit (C++11) cv_status (C++11) 信号量 counting_semaphorebinary_semaphore (C++20)(C++20) 闩与屏障 latch (C++20) barrier (C++20) future promise (C++11) future (C++11) shared_future (C++11) packaged_task (C++11) async (C++11) launch (C++11) future_status (C++11) future_error (C++11) future_category (C++11) future_errc (C++11)

 

std::stop_callback

成员函数

stop_callback::stop_callback

stop_callback::~stop_callback

推导指引

 

在标头 <stop_token> 定义
template< class Callback > class stop_callback;		(C++20 起)

stop_callback 类模板提供对关联的 std::stop_token 对象注册回调函数的 RAII 对象类型，使得将在 std::stop_token 的关联 std::stop_source 被请求停止时调用回调函数。

在对该 stop_callback 的关联 std::stop_token 的std::stop_source 成功调用 request_stop() 的同一线程调用经由 stop_callback 构造函数注册的回调函数；或若在构造函数的注册前已请求停止，则在构造 stop_callback 的线程调用回调函数。

能在同一或不同线程同时对同一 std::stop_token 创建多于一个 stop_callback 。不提供对执行它们所用顺序的保证，但将同步调用它们；除了对已对 std::stop_token 请求停止后构造的 stop_callback 如前述。

若调用的回调经由异常退出，则调用 std::terminate 。

std::stop_callback 非可复制构造 (CopyConstructible) 、可复制赋值 (CopyAssignable) 、可移动构造 (MoveConstructible) 亦非可移动赋值 (MoveAssignable) 。

模板形参 Callback 类型必须为 invocable 且 destructible 。忽略任何返回值。

成员类型

类型	定义
callback_type	Callback

成员函数

(构造函数)	构造新的 stop_callback 对象 (公开成员函数)
(析构函数)	析构 stop_callback 对象 (公开成员函数)
operator= [被删除]	stop_callback 不可赋值 (公开成员函数)