FindOpenThreads

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

find_package(OpenThreads [...])

OpenThreads 头文件意图作为

example.cxx

#include <OpenThreads/Thread>

结果变量

此模块定义了以下变量

OpenThreads_FOUND

3.3 版本中新增。

布尔值，指示是否找到 OpenThreads 库。

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_FOUND

自版本 4.2 起已弃用： 使用 OpenThreads_FOUND，其值相同。

布尔值，指示是否找到 OpenThreads 库。

示例

查找 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)