45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
|
# 强化线程能力
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
### 简介
|
|||
|
|
|
|||
|
|
线程类提供例如启动线程、同步通知、异步通知等功能的接口
|
|||
|
|
|
|||
|
|
`#include <thread_ex.h>`
|
|||
|
|
|
|||
|
|
## 涉及功能
|
|||
|
|
|
|||
|
|
### 接口说明
|
|||
|
|
|
|||
|
|
### OHOS::Thread
|
|||
|
|
|
|||
|
|
|
|||
|
|
|返回值类型 | 名称 |
|
|||
|
|
| ------------ | ------------------------------------------------------------ |
|
|||
|
|
| | **Thread**()<br/>构造函数, 构造一个Thread对象，但并不会启动线程。 |
|
|||
|
|
| | virtual **~Thread**()<br/>析构函数 |
|
|||
|
|
| ThreadStatus | **Start**(const std::string& name, int32_t priority = THREAD_PROI_NORMAL, size_t stack = 0);<br/>创建并启动一个子线程，循环执行Run()，当Run()返回false或通知退出时停止。 |
|
|||
|
|
| ThreadStatus | **NotifyExitSync**()<br/>同步通知线程退出,即阻塞式停止子线程。<br/>当前线程被阻塞，等待子线程结束。 |
|
|||
|
|
| void | virtual **NotifyExitAsync**()<br/>异步通知线程退出，即子线程退出与否不阻塞当前线程。<br/>通知子线程停止，当前线程继续运行。 |
|
|||
|
|
| bool | virtual **ReadyToWork**()<br/>判断线程是否已经准备就绪，始终返回true。 |
|
|||
|
|
| bool | **IsExitPending**() const<br/>获取线程退出待定标志位。 |
|
|||
|
|
| bool | **IsRunning**() const<br/>判断线程是否在运行 |
|
|||
|
|
| pthread_t | **GetThread**() const<br/>获取线程ID |
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
1. 测试用例编译运行方法
|
|||
|
|
|
|||
|
|
- 测试用例代码参见base/test/unittest/common/utils_thread_test.cpp
|
|||
|
|
|
|||
|
|
- 使用开发者自测试框架，使用方法参见：[开发自测试执行框架-测试用例执行](https://gitee.com/openharmony/testfwk_developer_test#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%E6%89%A7%E8%A1%8C)
|
|||
|
|
|
|||
|
|
- 使用以下具体命令以运行`thread_ex.h`对应测试用例
|
|||
|
|
```bash
|
|||
|
|
run -t UT -tp utils -ts UtilsThreadTest
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 常见问题
|