diff --git a/docs/zh-cn/c-utils-guide-thread.md b/docs/zh-cn/c-utils-guide-thread.md new file mode 100644 index 0000000000000000000000000000000000000000..24e2eb51fd55017c2a0db1166d91942251a1386e --- /dev/null +++ b/docs/zh-cn/c-utils-guide-thread.md @@ -0,0 +1,44 @@ +# 强化线程能力 + +## 概述 + +### 简介 + +线程类提供例如启动线程、同步通知、异步通知等功能的接口 + +`#include ` + +## 涉及功能 + +### 接口说明 + +### OHOS::Thread + + +|返回值类型 | 名称 | +| ------------ | ------------------------------------------------------------ | +| | **Thread**()
构造函数, 构造一个Thread对象,但并不会启动线程。 | +| | virtual **~Thread**()
析构函数 | +| ThreadStatus | **Start**(const std::string& name, int32_t priority = THREAD_PROI_NORMAL, size_t stack = 0);
创建并启动一个子线程,循环执行Run(),当Run()返回false或通知退出时停止。 | +| ThreadStatus | **NotifyExitSync**()
同步通知线程退出,即阻塞式停止子线程。
当前线程被阻塞,等待子线程结束。 | +| void | virtual **NotifyExitAsync**()
异步通知线程退出,即子线程退出与否不阻塞当前线程。
通知子线程停止,当前线程继续运行。 | +| bool | virtual **ReadyToWork**()
判断线程是否已经准备就绪,始终返回true。 | +| bool | **IsExitPending**() const
获取线程退出待定标志位。 | +| bool | **IsRunning**() const
判断线程是否在运行 | +| pthread_t | **GetThread**() const
获取线程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 +``` + +## 常见问题