线程

线程管理和相关操作 更多...

线程 的协作图:

类
class	lazy_thread
	延迟启动线程类 更多...
class	scoped_thread
	作用域线程类 更多...
class	thread
	线程类 更多...
class	thread_tracker
	线程跟踪器类 更多...

函数
int64_t	current_cpu () noexcept
	获取当前CPU核心编号
void	yield () noexcept
	让出当前线程的时间片
void	relax () noexcept
	线程放松
void	sleep_for_ms (uint32_t milliseconds) noexcept
	睡眠指定毫秒数
void	sleep_for_ms (uint32_t ms, bool busy_wait) noexcept
	精确睡眠指定毫秒数
void	sleep_for_us (uint64_t us) noexcept
	精确睡眠指定微秒数
void	sleep_for_ns (uint64_t ns) noexcept
	精确睡眠指定纳秒数
bool	set_affinity (size_t cpu_mask) noexcept
	设置线程的 CPU 亲和性
bool	affinity (uint64_t &affi) noexcept
	获取线程的 CPU 亲和性
bool	cpu_time (cpu_times &times) noexcept
	获取当前线程的 CPU 时间
bool	set_priority (int priority) noexcept
	设置线程优先级
int	priority () noexcept
	获取线程优先级
thread::id	id () noexcept
	获取当前线程标识符
thread::native_handle_type	handle () noexcept
	获取当前线程句柄
bool	name (char *buffer, size_t size)
	获取当前线程名称
bool	set_name (const char *name)
	设置当前线程名称
bool	is_single_threaded () noexcept
	检查当前是否处于单线程模式
int	thread_count () noexcept
	获取当前活动线程数量
template<typename Clock, typename Dur>
void	sleep_until (const time_point< Clock, Dur > &time)
	使当前线程睡眠直到指定时间点
template<typename Rep, typename Period>
void	sleep_for (const duration< Rep, Period > time)
	使当前线程睡眠指定时间

详细描述

线程管理和相关操作

函数说明

affinity()

bool affinity ( uint64_t & affi )

noexcept

获取线程的 CPU 亲和性

参数

affi

CPU 亲和性

返回

获取是否成功

cpu_time()

bool cpu_time ( cpu_times & times )

noexcept

获取当前线程的 CPU 时间

参数

times

用户态和内核态时间

返回

成功返回 true

current_cpu()

int64_t current_cpu ( )

inlinenoexcept

获取当前CPU核心编号

返回

当前线程运行的CPU核心编号

返回当前线程正在运行的CPU核心的逻辑编号。

在文件 this_thread.hpp 第 60 行定义.

handle()

thread::native_handle_type handle ( )

inlinenoexcept

获取当前线程句柄

返回

当前线程的句柄

在文件 thread.hpp 第 461 行定义.

被这些函数引用 virtual_thread_task< T >::promise_type::await_transform(), virtual_thread_task< T >::promise_type::await_transform(), virtual_thread_task< void >::promise_type::await_transform(), virtual_thread_task< void >::promise_type::await_transform(), file_async::file_async(), file_info::file_info(), file_locker::file_locker(), thread::name(), virtual_thread_scheduler::schedule() , 以及 thread::set_name().

id()

thread::id id ( )

inlinenoexcept

获取当前线程标识符

返回

当前线程的标识符

在文件 thread.hpp 第 449 行定义.

被这些函数引用 timer_scheduler< Clock >::add_task() , 以及 meta_type::meta_type().

is_single_threaded()

bool is_single_threaded ( )

inlinenoexcept

检查当前是否处于单线程模式

返回

如果只有主线程运行则返回true，否则返回false

在文件 thread_tracker.hpp 第 86 行定义.

引用了 thread_tracker::is_single_threaded().

name()

bool name ( char * buffer, size_t size )

inline

获取当前线程名称

参数

buffer	存储名称的缓冲区
size	缓冲区大小

返回

是否获取成功

在文件 thread.hpp 第 475 行定义.

引用了 thread::name() , 以及 size().

被这些函数引用 ini_document::add_section(), env_document::add_variable(), yaml_builder::alias(), yaml_builder::anchor(), toml_builder::begin_array_table(), ini_builder::begin_section(), toml_builder::begin_table(), http_server_request::cookie(), cmdline::count(), registry_key::create_sub_key(), registry_key::delete_sub_key(), registry_key::delete_value(), environment::exists(), registry::find(), path_tree::find_all(), path_tree::node::find_child(), registry::find_unlocked(), type_builder< T >::function(), type_builder< T >::function(), environment::get(), registry_key::get_binary_value(), env_document::get_bool(), env_document::get_double(), registry_key::get_dword_value(), env_document::get_int(), env_document::get_int64(), registry_key::get_multi_string_value(), plugin_manager::get_plugin(), registry_key::get_qword_value(), ini_document::get_section(), ini_document::get_section(), env_document::get_string(), registry_key::get_string_value(), env_document::get_variable(), env_document::get_variable(), cmdline::has(), http_server_request::has_cookie(), http_server_request::has_header(), http_server_response::has_header(), http_server_request::has_parameter(), ini_document::has_section(), registry_key::has_sub_key(), dynamic_library::has_symbol(), registry_key::has_value(), env_document::has_variable(), http_server_request::header(), http_server_response::header(), ini_section::ini_section(), registry_key::open_sub_key(), http_server_request::parameter(), type_builder< T >::property(), reflect(), registry::register_type(), path_tree::node::remove_child(), env_document::remove_variable(), environment::set(), registry_key::set_binary_value(), http_server_request::set_cookie(), http_server::set_cookie_name(), registry_key::set_dword_value(), registry_key::set_expand_string_value(), http_server_request::set_header(), http_server_response::set_header(), registry_key::set_multi_string_value(), ini_section::set_name(), set_name(), http_server_request::set_parameter(), registry_key::set_qword_value(), registry_key::set_string_value(), env_document::set_variable(), type_builder< T >::static_function(), dynamic_library::symbol(), dynamic_library::to_symbol(), type_builder< T >::type_builder(), plugin_manager::unload_plugin(), environment::unset() , 以及 ini_builder::value_section().

priority()

int priority ( )

noexcept

获取线程优先级

返回

当前线程的优先级值（0-100，0为最低）

获取当前线程的调度优先级。 若获取失败，返回 0。

被这些函数引用 signal< Types >::connect(), signal< Types >::connect(), signal< Types >::connect_filtered(), signal< Types >::connect_if(), signal< Types >::connect_if(), signal< Types >::connect_signal(), signal< Types >::connect_signal(), signal< Types >::connect_transformed(), get_current_task_group(), set_priority(), thread_pool::submit_after(), thread_pool::submit_every() , 以及 thread_pool::submit_task().

relax()

void relax ( )

inlinenoexcept

线程放松

使用CPU特定的暂停指令让当前线程短暂放松，减少CPU功耗。 适用于自旋锁等场景中的忙等待。

在文件 this_thread.hpp 第 87 行定义.

set_affinity()

bool set_affinity ( size_t cpu_mask )

noexcept

设置线程的 CPU 亲和性

参数

cpu_mask

CPU 掩码，每个位表示一个 CPU 核心

返回

设置是否成功

设置当前线程可以在哪些 CPU 核心上运行。

set_name()

bool set_name ( const char * name )

inline

设置当前线程名称

参数

name

线程名称

返回

是否设置成功

在文件 thread.hpp 第 484 行定义.

引用了 name() , 以及 thread::set_name().

set_priority()

bool set_priority ( int priority )

noexcept

设置线程优先级

参数

priority

优先级值

返回

设置是否成功

设置当前线程的调度优先级。

引用了 priority().

sleep_for()

template<typename Rep, typename Period>

void sleep_for

(

const duration< Rep, Period >

time

)

使当前线程睡眠指定时间

模板参数

Rep	数值类型
Period	时间单位比例

参数

time

要睡眠的时间

在文件 duration.hpp 第 886 行定义.

引用了 duration< Rep, Period >::count().

sleep_for_ms() [1/2]

void sleep_for_ms ( uint32_t milliseconds )

inlinenoexcept

睡眠指定毫秒数

参数

milliseconds

要睡眠的毫秒数

让当前线程睡眠指定的时间。

注解

使用系统睡眠，实际睡眠时间受系统调度影响。

在文件 this_thread.hpp 第 113 行定义.

sleep_for_ms() [2/2]

void sleep_for_ms ( uint32_t ms, bool busy_wait )

noexcept

精确睡眠指定毫秒数

参数

ms	要睡眠的毫秒数
busy_wait	是否使用忙等待获得更高精度

提供相对精确的睡眠功能。当use_busy_wait为true时，使用忙等待+系统睡眠组合 以获得更高的精度，但会增加CPU使用率。为false时使用纯系统睡眠。

注解

Windows平台最小精度通常为1-15ms，Linux为1ms，忙等待可达到微秒级精度

sleep_for_ns()

void sleep_for_ns ( uint64_t ns )

noexcept

精确睡眠指定纳秒数

参数

ns

要睡眠的纳秒数

提供纳秒级精度的睡眠，主要用于极短时间延迟。

注解

实际精度受CPU频率和指令执行时间限制。

sleep_for_us()

void sleep_for_us ( uint64_t us )

noexcept

精确睡眠指定微秒数

参数

us

要睡眠的微秒数

提供微秒级精度的睡眠，主要用于短时间延迟。

注解

实际精度受系统时钟精度限制。

sleep_until()

template<typename Clock, typename Dur>

void sleep_until

(

const time_point< Clock, Dur > &

time

)

使当前线程睡眠直到指定时间点

模板参数

Clock	时钟类型
Dur	持续时间类型

参数

time

要睡眠到的时间点

跨平台的线程睡眠函数，支持稳定时钟和非稳定时钟。

• 对于稳定时钟，计算一次睡眠时间；
• 对于非稳定时钟，循环检查直到达到目标时间。

在文件 clocks.hpp 第 174 行定义.

thread_count()

int thread_count ( )

inlinenoexcept

获取当前活动线程数量

返回

活动的NexusForce线程数量

在文件 thread_tracker.hpp 第 92 行定义.

引用了 thread_tracker::thread_count().

yield()

void yield ( )

inlinenoexcept

让出当前线程的时间片

主动让出当前线程的CPU时间片，让其他线程可以运行。

在文件 this_thread.hpp 第 73 行定义.