winux::Thread类 参考

线程 更多...

#include <threads.hpp>

Public 类型
typedef void *(*	ThreadFuncPtr) (void *param)
	线程处理函数指针类型 更多...

Public 成员函数
	Thread (bool isStartup=false)
	构造函数1 更多...
template<typename _Fx , typename... _ArgType>
	Thread (bool isStartup, _Fx routine, _ArgType &&...arg)
	构造函数2 更多...
virtual	~Thread ()
	析构函数 更多...
	Thread (Thread &&other)
	移动构造 更多...
Thread &	operator= (Thread &&other)
	移动赋值 更多...
int	startup ()
	实际创建一个线程 更多...
template<typename _Fx , typename... _ArgType>
int	startup (_Fx routine, _ArgType &&...arg)
	实际创建一个线程，提供你自己的处理例程 更多...
int	startupEx (ThreadFuncPtr startRoutine, void *param)
	实际创建一个线程，提供你自己的处理函数 更多...
void *	joined ()
	被调用者线程连接 更多...
int	detach ()
	使线程分离 更多...
void	setSchedParam (SchedulePolicy policy, int priority)
	设置调度策略、调度参数 更多...
void	getSchedParam (SchedulePolicy *policy, int *priority) const
	获取调度策略、调度参数 更多...
ThreadAttr &	attr ()
	设置线程属性对象，下次startup()时生效 更多...
template<typename _Fx , typename... _ArgType>
Thread &	setRunable (_Fx routine, _ArgType &&...arg)
	设置Runable，run()默认会调用它 更多...
Thread &	setDeleter (SimpleDeleterContext *deleter=NULL)
	设置删除器场景以便默认线程函数删除Thread对象自己 更多...
Thread &	setDefaultDeleter ()
	设置默认删除器场景以便默认线程函数删除Thread对象自己 更多...
template<typename _Dt >
Thread &	setCustomDeleter (_Dt fn)
	设置自定义删除器场景以便默认线程函数删除Thread对象自己 更多...
void *	getExitVal () const
	取得退出值 更多...
Thread &	setExitVal (void *exitVal)
	设置退出值，可在run()中调用 更多...
ThreadId	get () const
	线程Id 更多...

静态 Public 成员函数
static ThreadId	Self ()
	得到调用者线程的ThreadId 更多...
static void	Exit (void *exitVal=NULL)
	调用者线程退出 更多...
static void *	Join (Thread &otherThread)
	调用者线程连接指定其他线程 更多...
static void	SetConcurrency (int newLevel)
	设置建议并发数 更多...
static int	GetConcurrency (void)
	获取并发数 更多...

Protected 成员函数
virtual void	run ()
	线程处理函数，默认调用内部的Runable，派生线程类可重写此函数 更多...

Protected 属性
struct _ThreadFuncParam *	_param
	线程函数的参数 更多...

友元
class	ThreadGroup

详细描述

线程

在文件 threads.hpp 第 149 行定义.

成员类型定义说明

typedef void*(* winux::Thread::ThreadFuncPtr) (void *param)

线程处理函数指针类型

在文件 threads.hpp 第 153 行定义.

构造及析构函数说明

winux::Thread::Thread ( bool  isStartup = false )

inlineexplicit

构造函数1

参数

isStartup

是否立即启动线程。 当isStartup=false时不立即创建线程，用户手动调用startup()函数创建线程。 当isStartup=true时立即创建一个线程，以run()作为线程处理函数，用户需要派生Thread类重写run()函数以定义自己的处理。

在文件 threads.hpp 第 185 行定义.

template<typename _Fx , typename... _ArgType>

winux::Thread::Thread ( bool  isStartup, _Fx  routine, _ArgType &&...  arg  )

inlineexplicit

构造函数2

立即创建一个线程，以routine作为线程处理例程

在文件 threads.hpp 第 194 行定义.

virtual winux::Thread::~Thread ( )

virtual

析构函数

winux::Thread::Thread

(

Thread &&

other

)

移动构造

成员函数说明

static ThreadId winux::Thread::Self ( )

static

得到调用者线程的ThreadId

static void winux::Thread::Exit ( void *  exitVal = NULL )

static

调用者线程退出

static void* winux::Thread::Join ( Thread &  otherThread )

static

调用者线程连接指定其他线程

退出状态由返回值或者otherThread.getExitVal()取得

static void winux::Thread::SetConcurrency ( int  newLevel )

static

设置建议并发数

异常

ThreadSysError

static int winux::Thread::GetConcurrency ( void  )

static

获取并发数

Thread& winux::Thread::operator=

(

Thread &&

other

)

移动赋值

int winux::Thread::startup

(

)

实际创建一个线程

以run()作为线程处理，用户可继承Thread类重写run()方法以定义自己的处理；也可以setRunable()设置一个可运行对象作为线程处理例程
startup()会设置Thread::_isRunning为true，在默认的线程处理函数里，调用完run()方法后设置Thread::_isRunning为false

template<typename _Fx , typename... _ArgType>

int winux::Thread::startup ( _Fx  routine, _ArgType &&...  arg  )

inline

实际创建一个线程，提供你自己的处理例程

在文件 threads.hpp 第 217 行定义.

int winux::Thread::startupEx	(	ThreadFuncPtr	startRoutine,
		void *	param
	)

实际创建一个线程，提供你自己的处理函数

void* winux::Thread::joined

(

)

被调用者线程连接

int winux::Thread::detach

(

)

使线程分离

一个可连接线程启动后必须调用joined()来等待运行完毕，内部资源才能正确释放。调用此detach()方法后不能再调用joined()方法。
此时，线程函数若有访问Thread对象的数据，必须保证线程运行结束前Thread对象的存在，但是因为没有了joined()方法的同步，你需要自己设计代码来保证对象不会提前释放。
设置删除器可以一定程度上简化代码，如果Thread对象设置了删除器，那默认的线程函数处理时会在运行结束前调用删除器释放Thread对象。
若你调用了startupEx()提供自己的线程处理函数，那就需要自己设计代码来保证Thread对象不会提前释放。

void winux::Thread::setSchedParam	(	SchedulePolicy	policy,
		int	priority
	)

设置调度策略、调度参数

异常

ThreadSysError

void winux::Thread::getSchedParam	(	SchedulePolicy *	policy,
		int *	priority
	)		const

获取调度策略、调度参数

异常

ThreadSysError

ThreadAttr& winux::Thread::attr

(

)

设置线程属性对象，下次startup()时生效

template<typename _Fx , typename... _ArgType>

Thread& winux::Thread::setRunable ( _Fx  routine, _ArgType &&...  arg  )

inline

设置Runable，run()默认会调用它

在文件 threads.hpp 第 254 行定义.

Thread& winux::Thread::setDeleter ( SimpleDeleterContext *  deleter = NULL )

inline

设置删除器场景以便默认线程函数删除Thread对象自己

在文件 threads.hpp 第 261 行定义.

Thread& winux::Thread::setDefaultDeleter ( )

inline

设置默认删除器场景以便默认线程函数删除Thread对象自己

在文件 threads.hpp 第 268 行定义.

template<typename _Dt >

Thread& winux::Thread::setCustomDeleter ( _Dt  fn )

inline

设置自定义删除器场景以便默认线程函数删除Thread对象自己

在文件 threads.hpp 第 272 行定义.

void* winux::Thread::getExitVal ( ) const

inline

取得退出值

在文件 threads.hpp 第 275 行定义.

Thread& winux::Thread::setExitVal ( void *  exitVal )

inline

设置退出值，可在run()中调用

在文件 threads.hpp 第 277 行定义.

ThreadId winux::Thread::get ( ) const

inline

线程Id

在文件 threads.hpp 第 284 行定义.

virtual void winux::Thread::run ( )

protectedvirtual

线程处理函数，默认调用内部的Runable，派生线程类可重写此函数

友元及相关函数文档

friend class ThreadGroup

friend

在文件 threads.hpp 第 303 行定义.

类成员变量说明

struct _ThreadFuncParam* winux::Thread::_param

protected

线程函数的参数

在文件 threads.hpp 第 292 行定义.

---

该类的文档由以下文件生成:

• threads.hpp