一、多线程编程常用函数用法

1、pthread_create

头文件

#include<pthread.h>

函数声明

int pthread_create(pthread_t*restrict tidp,const pthread_attr_t *restrict_attr,void*（*start_rtn)(void*),void *restrict arg)

函数功能

pthread_create是UNIX环境创建线程函数

参数介绍

1）参数一：为指向线程标识符的指针
2）参数二：用来设置线程属性
3）参数三：是线程运行函数的起始地址
4）参数四：运行函数的参数

返回值

线程创建成功返回0，否则返回错误码

注意

在编译时注意加上-lpthread参数，以调用动态链接库，pthread并非Linux系统的默认库

2、pthread_join

头文件

#include<pthread.h>

函数声明

int pthread_join(pthread_t thread, void **retval);

函数功能

函数pthread_join用来等待一个线程的结束

函数参数

1）参数一：被等待的线程标识符
2）参数二：用户定义的指针，它可以用来存储被等待线程的返回值

函数返回值

如果执行成功，将返回0，如果失败则返回一个错误码

注意

这个函数是一个线程阻塞的函数，调用它的线程将一直等待到被等待的线程结束为止，当函数返回时，被等待线程的资源被收回

示例

#include <stdio.h>
#include <stdlib.h>
#include <pthread.h>
#include <sys/prctl.h>struct data {int num;char *name;
};void* pthread(void *arg) {/* 设置线程名称 */prctl(PR_SET_NAME, "sub thread");/* 获取线程名称 */ char threadName[30];prctl(PR_GET_NAME, threadName); /* pthread线程开始运行 */printf("%s start!\\n", threadName);/* 令主线程继续执行 */sleep(5);/* 输出主线程传入的数据	*/ struct data *p = (struct data *)arg;printf("num is %d!\\n", p->num);printf("name is %s!\\n", p->name);return NULL;
}void main() 
{	/* 设置主线程名称 */prctl(PR_SET_NAME, "main thread");/* 创建pthread线程，并传入自定义数据 */pthread_t tidp;struct data *p = (struct data *)malloc(sizeof(struct data));p->num = 10;p->name = "jams";if (pthread_create(&tidp, NULL, pthread, (void*)p) != 0) {printf("create error!\\n");return;}/* 令pthread线程先运行 */sleep(1);/* pthread线程sleep 5s，此时主线程开始工作 */printf("main thread continue!\\n");/* 等待pthread释放 */if (pthread_join(tidp, NULL) != 0) {printf("pthread_join error!\\n");return;}printf("pthread is end!\\n");
}

3、pthread_cancel

头文件

#include<pthread.h>

函数声明

int pthread_cancel(pthread_t thread);

函数功能

终止线程的执行，多线程程序中，一个线程可以借助 pthread_cancel() 函数向另一个线程发送“终止执行”的信号（后续称“Cancel”信号），从而令目标线程结束执行。

函数参数

1）thread线程ID

函数返回值

pthread_cancel() 函数成功地发送了 Cancel 信号，返回数字 0；反之如果发送失败，函数返回值为非零数。对于因“未找到目标线程”导致的信号发送失败，函数返回ESRCH宏。

注意

pthread_cancel() 函数的功能仅仅是向目标线程发送cancel信号，至于目标线程是否处理该信号以及何时结束执行，由目标线程决定

4、pthread_kill

头文件

#include<pthread.h>

函数声明

int pthread_kill(pthread_t thread, int sig)

函数功能

向指定的线程发送信号

函数参数

1）thread目标线程
2）sig要发送的信号

函数返回值

函数调用成功返回0，失败返回非0值

注意

0是保留信号，用来判断线程是否存在

示例

int ThreadMonitorImpl::CSFRegThreadMonitor(pthread_t tid, CSF_THREAD_MONITOR_TYPE_E monitorType,CSF_THREAD_MONITOR_CONFIG_UNION monitorConfig)
{int isAlive = pthread_kill(tid, 0);if (isAlive == ESRCH) {STD_LOG(LOG_LEVEL_ERR, "CSFRegThreadMonitor, tid is invalid or thread already exit, tid is %d", tid);return ERR_THREAD_MONITOR_TID_INVALID;} else if (isAlive == EINVAL) {STD_LOG(LOG_LEVEL_ERR, "CSFRegThreadMonitor, check is thread exist failed");}if (THREADMONITOR->threadIdStatusIndex.count(tid) > 0) { /* 任务重复时拒绝 */std::map<CSF_THREAD_MONITOR_TYPE_E, void *> &originThreadStatus = THREADMONITOR->threadIdStatusIndex[tid];if (originThreadStatus.count(monitorType) > 0) {STD_LOG(LOG_LEVEL_ERR, "add thread to monitor list failed, reason: repeat reg]tid=%lu, monitorType=%d",(unsigned long)tid, (int)monitorType);return ERR_THREAD_MONITOR_ADD_REPEAT;}}