FindOpenThreads

查找基于 C++ 的 OpenThreads 线程库。

OpenThreads 头文件的包含方式为:

example.cxx
#include <OpenThreads/Thread>

结果变量

此模块定义了以下变量

OpenThreads_FOUND

一个布尔值,指示是否找到 OpenThreads 库。为了向后兼容,OPENTHREADS_FOUND 变量也设置为相同的值。

OPENTHREADS_LIBRARY

使用 OpenThreads 所需链接的库。这提供了发布(优化)或调试库的变体,这些库根据项目的构建配置单独查找。

缓存变量

以下缓存变量也可以设置

OPENTHREADS_INCLUDE_DIR

包含使用 OpenThreads 所需头文件的目录。

提示

此模块接受以下变量

OPENTHREADS_DIR

一个环境变量或 CMake 变量,可以设置该变量以帮助查找安装在自定义位置的 OpenThreads 库。它应该指向在配置、构建和安装 OpenThreads 库时使用的安装目标:./configure --prefix=$OPENTHREADS_DIR

此模块最初是为了支持 FindOpenSceneGraph 模块及其组件而引入的。为了简化 OpenSceneGraph 包在上游开发和分发时的一步自动化配置和构建,此模块支持额外的环境变量以在特定位置查找依赖项。上游包使用此方法而不是在命令行上指定 -DVAR=value,因为它提供了更好的与模块内部更改的隔离,并且在独立于 CMAKE_*_PATH 变量指定各个 OSG 组件时提供了更大的灵活性。如果需要,显式的 -DVAR=value 参数仍然可以覆盖这些设置。由于 OpenThreads 是 OpenSceneGraph 的一个可选独立依赖项,因此此模块为了方便也支持以下变量:

OSG_DIR

可以设置为环境变量或 CMake 变量。其作用与 OPENTHREADS_DIR 相同。

OSGDIR

作用与 OPENTHREADS_DIR 相同的环境变量。

示例

查找 OpenThreads 库并创建一个接口 导入目标,该目标封装了其链接到项目目标的用法要求。

find_package(OpenThreads)

if(OpenThreads_FOUND AND NOT TARGET OpenThreads::OpenThreads)
  add_library(OpenThreads::OpenThreads INTERFACE IMPORTED)
  set_target_properties(
    OpenThreads::OpenThreads
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OPENTHREADS_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OPENTHREADS_LIBRARY}"
  )
endif()

target_link_libraries(example PRIVATE OpenThreads::OpenThreads)