在本章节中：

前提条件

要启用测试多线程应用程序的功能，请在【构建】设置的【编译器】选项（如设置项目和文件选项中所述）中添加以下选项：

"-DCPPTEST_THREADS=1"

此选项将激活 C++test 的运行时库中的多线程支持，并禁用对线程相关例程使用安全桩函数

注意事项

C++test 的测试可执行文件必须与适当的运行时库链接（即，用于 Visual C++ 编译器的 C 运行时库的多线程版本或 UNIX 上的 pthread 库）。
C++test 的运行时不控制线程的生存时间 - 我们建议您实施测试用例，以便在测试用例完成时终止所有线程。

已知的问题和限制

已知的问题和限制：

如果启用了多线程支持(使用 -DCPPTEST_THREADS=1)，但是在链接期间没有使用适当的库(或者一个多线程和单线程的 C Runtime 混合使用)，那么测试可执行文件可能会产生损坏的测试结果，或者可能会意外终止。
非主线程中的意外行为(信号、未处理异常、超时)将导致测试可执行文件终止。

构建 C++test 运行时库

C++test 默认的运行时库具有对测试多线程应用程序的内置支持。除非您要构建具有多线程支持的自定义运行时库（例如，用于嵌入式测试），否则无需执行其他操作。如果您需要使用多线程支持来构建自定义运行时库，请将 "- DCPPTEST_THREADS_ENABLED=1" 添加到编译器命令行。

支持的线程 API

运行时库的实现可以使用以下类型的线程 API：

Windows 线程
POSIX 线程
VxWorks 6.x

使用其他线程 API

如果需要使用其他线程 API（或自定义的 API），则必须实现以下类型和例程。

注意，C++test 运行时源中的 CppTestThread.c 文件包含线程支持例程的定义；它可以用作示例或更改的基础。

TIs - 线程本地存储

typedef IMPLEMENTATION_DEPENDENT_TYPE CppTestThreadKey;
/**
* Creates key for thread local storage data * Returns 0 on success
*/
extern int localThreadKeyCreate(CppTestThreadKey* key);
/**
* Deletes key for thread local storage data * Returns 0 on success
*/
extern int localThreadKeyDelete(CppTestThreadKey key);
/**
* Returns a thread specific value associate with a key */
extern void* localThreadGetSpecific(CppTestThreadKey key);
/**
* Associate a thread specific value with a key * Returns 0 on success
*/
extern int localThreadSetSpecific(CppTestThreadKey key, void* value);

Mutex

注意：C++test 运行时假设互斥对象可以静态初始化。

typedef IMPLEMENTATION_DEPENDENT_TYPE CppTestThreadMutex;
#define CPPTEST_THREADS_MUTEX_STATIC_INIT <IMPLEMENTATION_DEPENDENT_STATIC_INITIALIZER>
/**
* Initializes mutex
 * @return 0 on success
 */
extern int localThreadMutexInit(CppTestThreadMutex* mutex);
/**
* Destroy and release resources used by mutex * @return 0 on success
*/
extern int localThreadMutexDestroy(CppTestThreadMutex* mutex);
/**
* Lock mutext and return when calling thread becames is owner of it. * @return 0 on success
*/
extern int localThreadMutexLock(CppTestThreadMutex* mutex);
/**
 * Releases mutex owned by calling thread.
 * @return 0 on success
 */
extern int localThreadMutexUnlock(CppTestThreadMutex* mutex);

Miscellaneous

/**
 * Exits calling thread
 * (never returns)
 */
extern void localThreadExit();
/**
* @return non-zero if threads already finished execution */
extern int localThreadFinished(CppTestThread* thread);
/**
* @return non-zero if threads are supported in current build 
* (proper macros, libraries, compiler options were used).
*/
extern int localThreadsSupported(void);
/**
 * Initializes given thread structure
 */
extern void localThreadInit(CppTestThread* thread);