线程基本编程——线程函数大全

水深无声 2023-11-07 07:52 89阅读 0赞

索引：  
1.创建线程pthread\_create  
2.等待线程结束pthread\_join  
3.分离线程pthread\_detach  
4.创建线程键pthread\_key\_create  
5.删除线程键pthread\_key\_delete  
6.设置线程数据pthread\_setspecific  
7.获取线程数据pthread\_getspecific  
8.获取线程标示符pthread\_self  
9.比较线程pthread\_equal  
10.一次执行pthread\_once  
11.出让执行权sched\_yield  
12.修改优先级pthread\_setschedparam  
13.获取优先级pthread\_getschedparam  
14.发送信号pthread\_kill  
15.设置线程掩码pthread\_sigmask  
16.终止线程pthread\_exit  
17.退出线程pthread\_cancel  
18.允许/禁止退出线程pthread\_setcancelstate  
19.设置退出类型pthread\_setcanceltype  
20.创建退出点pthread\_testcancel  
21.压入善后处理函数  
22.弹出善后处理函数  
\--------------------------------------------------------------------------------  
1.创建线程pthread\_create  
\#include  
int pthread\_create(pthread\_t \*tid, const pthread\_attr\_t \*tattr, void \*(\*start\_routine)(void \*), void \*arg);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
创建一个线程。  
参数tattr中含有初始化线程所需要的属性，start\_routine是线程入口函数的地址，当start\_routine返回时，相应的线程就结束了。  
当函数成功时，线程标示符保存在参数tid指向的内存中。  
如果不指定属性对象，将其置为NULL，则创建一个缺省的线程，有如下属性：  
非绑定的；  
未分离的；  
由一个缺省大小的堆栈；  
具有和父线程一样的优先级。  
注意：在创建子线程时，传给子线程的输入参数最好是由malloc()函数返回的指针或指向全局变量的指针，而不要是指向局部变量的指针。要保证子线程处理参数时，该区域仍然有效。  
\--------------------------------------------------------------------------------  
2.等待线程结束pthread\_join  
\#include  
int pthread\_join(pthread\_t tid, void \*\*status);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
等待一个线程结束。  
该函数阻塞调用它线程，直到参数tid指定的线程结束。  
tid指定的线程必须在当前进程中，同时tid指定的线程必须是非分离的。  
不能有多个线程等待同一个线程终止。如果出现这种情况，一个线程将成功返回，别的线程将返回错误ESRCH。  
如果参数status不为NULL，则将线程的退出状态放在status指向的内存中。  
\--------------------------------------------------------------------------------  
3.分离线程pthread\_detach  
\#include  
int pthread\_detach(pthread\_t tid);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
将非分离的线程设置为分离线程。即通知线程库在指定的线程终止时回收线程占用的内存等资源。  
在一个线程上使用多次pthread\_detach的结果是不可预见的。  
\--------------------------------------------------------------------------------  
4.创建线程键pthread\_key\_create  
\#include  
int pthread\_key\_create(pthread\_key\_t \*key, void (\*destructor)(void\*));  
返回值：函数成功返回0。任何其他返回值都表示错误。  
在进程中分配一个键值，这个键被用来表示一个线程数据项。这个键对进程中所有的线程都是可见的。刚创建线程数据键时，在所有线程中和这个键相关联的值都是NULL。  
函数成功返回后，分配的键放在key参数指向的内存中，必须保证key参数指向的内存区的有效性。  
如果指定了解析函数destructor，那么当线程结束时并且将非空的值绑定在这个键上，系统将调用destructor函数，参数就是相关线程与这个键绑定的值。绑定在这个键上的内存块可由destructor函数释放。  
\--------------------------------------------------------------------------------  
5.删除线程键pthread\_key\_delete  
\#include  
int pthread\_key\_delete(pthread\_key\_t key);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
删除线程数据键。这个键占用的内存将被释放，该键再被引用将返回错误。  
在调用该函数之前，程序必须释放和本线程相关联的资源，该函数不会引发线程数据键的解析函数。  
\--------------------------------------------------------------------------------  
6.设置线程数据pthread\_setspecific  
\#include  
int pthread\_setspecific(pthread\_key\_t key, const void \*value);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
设置和某个线程数据键绑定在一起的线程专用数据（一般是指针）。  
函数不会释放原来绑定在键上的内存，给一个键值绑定新的指针时，必须释放原指针指向的内存，否则会发生内存泄漏。  
\--------------------------------------------------------------------------------  
7.获取线程数据pthread\_getspecific  
\#include  
void pthread\_getspecific(pthread\_key\_t key, void \*\*value);  
无返回值。出错时value指向NULL。  
获取绑定在线程数据键上的值，并在指定的位置存储取来的值。  
\--------------------------------------------------------------------------------  
8.获取线程标示符pthread\_self  
\#include  
pthread\_t pthread\_self(void);  
返回当前线程的标示符。  
\--------------------------------------------------------------------------------  
9.比较线程pthread\_equal  
\#include  
int pthread\_equal(pthread\_t tid1, pthread\_t tid2);  
如果tid1和tid2相同，函数返回一个非0值，否则返回0。  
如果tid1或tid2中任何一个是非法值，则返回将是不可预料的。  
\--------------------------------------------------------------------------------  
10.一次执行pthread\_once  
\#include  
int pthread\_once(pthread\_once\_t \*once\_control, void (\*init\_routine)(void));  
返回值：函数成功返回0。任何其他返回值都表示错误。  
函数用来调用初始化函数。如果已经有线程通过pthread\_once调用过这个初始化函数一次，那么以后通过pthread\_once函数再调用这个初始化函数将无效。  
参数once\_control决定了相应的初始化函数是否被调用过。它一般如下使用：  
\[static\] pthread\_once\_t once\_control = PTHREAD\_ONCE\_INIT。  
\--------------------------------------------------------------------------------  
11.出让执行权sched\_yield  
\#include  
int sched\_yield(void);  
返回值：函数成功返回0。-1表示错误。  
把当前线程的执行权（即对处理器的控制权）出让给另一个有相同或更高优先级的线程。  
\--------------------------------------------------------------------------------  
12.修改优先级pthread\_setschedparam  
\#include  
int pthread\_setschedparam(pthread\_t tid, int policy, const struct sched\_param \*param);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
修改线程的优先权。  
\--------------------------------------------------------------------------------  
13.获取优先级pthread\_getschedparam  
\#include  
int pthread\_getschedparam(pthread\_t tid, int policy, struct schedparam \*param);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
获取线程的优先级。  
\--------------------------------------------------------------------------------  
14.发送信号pthread\_kill  
\#include  
int pthread\_kill(pthread\_t tid, int sig);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
向tid指定的线程发送一个信号，tid指定的线程必须和当前线程在同一个进程中。  
当sig参数为0时，函数将进行错误检查，不发送信号，这常常用来检查tid的合法性。  
\--------------------------------------------------------------------------------  
15.设置线程掩码pthread\_sigmask  
\#include  
\#include  
int pthread\_sigmask(int how, const sigset\_t \*new, sigset\_t \*old);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
改变或检验当前线程的信号掩码。  
参数how表示对当前信号掩码进行什么操作，有如下值：SIG\_BLOCK、SIG\_UNBLOCK、SIG\_SETMASK。  
当参数new为NULL时，不论how的值是什么，当前线程的信号掩码都不会改变。  
旧的信号掩码保存在参数old指向的内存中，当old不为NULL时。  
\--------------------------------------------------------------------------------  
16.终止线程pthread\_exit  
\#include  
void pthread\_exit(void \*status);  
终止当前线程，所有绑定在线程数据键上的内存将被释放。如果当前线程是非分离的，那么这个线程的标示符合退出代码将被保留，直到其他线程用pthread\_join来等待当前线程的终止。如果当前线程是分离的，status将被忽略，线程标示符将被立即回收。  
若status不为NULL，线程的退出代码被置为status参数指向的值。  
\--------------------------------------------------------------------------------  
17.退出线程pthread\_cancel  
\#include  
int pthread\_cancel(pthread\_t thread);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
退出一个线程。如何响应退出请求取决于目标线程的状态。  
\--------------------------------------------------------------------------------  
18.允许/禁止退出线程pthread\_setcancelstate  
\#include  
int pthread\_setcancelstate(int state, int \*oldstate);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
参数state取值为PTHREAD\_CANCEL\_ENABLE或PTHREAD\_CANCEL\_DISABLE。  
\--------------------------------------------------------------------------------  
19.设置退出类型pthread\_setcanceltype  
\#include  
int pthread\_setcanceltype(int type, int \*oldtype);  
返回值：函数成功返回0。任何其他返回值都表示错误。  
将线程退出类型设置为延迟类型或异步类型。参数type的取值为PTHREAD\_CANCEL\_DEFERRED或PTHREAD\_CANCEL\_ASYNCHRONOUS。  
当一个线程被创建后，缺省值是延迟类型。在异步方式下，线程可以在执行的任何时候被退出。  
\--------------------------------------------------------------------------------  
20.创建退出点pthread\_testcancel  
\#include  
void pthread\_testcancel(void);  
无返回值。  
设置线程的退出点。  
只有当线程的退出状态是允许退出的，而且线程的退出类型是延迟时，调用该函数才有效。如果调用时线程的退出状态是禁止的，则该调用不起作用。  
小心使用该函数，只有在能够安全的被退出的地方才能够设置退出点。  
\--------------------------------------------------------------------------------  
21.压入善后处理函数  
\#include  
void pthread\_cleanup\_push(void (\*routine)(void \*), void \*args);  
将一个善后处理函数压入善后处理函数堆栈。  
\--------------------------------------------------------------------------------  
22.弹出善后处理函数  
\#include  
void pthread\_cleanup\_pop(int execute);  
从善后处理函数堆栈中弹出一个善后处理函数。如果参数execute非0，则执行弹出的函数；如果参数为0，则不执行弹出函数。  
如果一个线程显式或隐式的调用pthread\_exit()函数或线程接受了退出请求，线程库实际上将会以非0参数调用pthread\_cleanup\_pop函数。