Files
phs_v1.0.1.0/commonlibrary/c_utils/docs/zh-cn/c-utils-guide-thread.md
2024-09-27 19:16:49 +08:00

1.9 KiB
Raw Blame History

强化线程能力

概述

简介

线程类提供例如启动线程、同步通知、异步通知等功能的接口

#include <thread_ex.h>

涉及功能

接口说明

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

  • 使用开发者自测试框架,使用方法参见:开发自测试执行框架-测试用例执行

  • 使用以下具体命令以运行thread_ex.h对应测试用例

run -t UT -tp utils -ts UtilsThreadTest

常见问题