第 7 步:添加系统内省

我们考虑向可能会缺少目标平台功能的项目添加一些代码。在此示例中,我们将添加一些代码,该代码取决于目标平台是否有 logexp 函数。当然,几乎每个平台都有这些函数,但本教程假定它们并不常见。

练习 1 - 评估依赖项的可用性

目标

根据可用的系统从属关系更改实现方法。

有用的资源

要编辑的文件

  • MathFunctions/CMakeLists.txt

  • MathFunctions/mysqrt.cxx

入门

Step7 目录中提供了初学者源代码。在此练习中,完成 TODO 1TODO 5

首先编辑 MathFunctions/CMakeLists.txt。包含 CheckCXXSourceCompiles 模块。然后,使用 check_cxx_source_compiles 确定是否可以使用 cmath 提供 logexp。如果可以使用,请使用 target_compile_definitions() 指定 HAVE_LOGHAVE_EXP 作为编译定义。

MathFunctions/mysqrt.cxx 中,包含 cmath。然后,如果系统有 logexp,请使用它们计算平方根。

构建并运行

创建一个名为 Step7_build 的新目录。运行 cmake 可执行文件或 cmake-gui 来配置项目,然后使用你选择构建工具对其进行构建,并运行 Tutorial 可执行文件。

代码类似以下

mkdir Step7_build
cd Step7_build
cmake ../Step7
cmake --build .

现在哪个函数给出了更好的结果,sqrt 还是 mysqrt

解决方案

在此练习中,我们将使用 CheckCXXSourceCompiles 模块中的函数,所以我们必须首先在 MathFunctions/CMakeLists.txt 中包含它。

TODO 1:单击显示/隐藏答案
TODO 1: MathFunctions/CMakeLists.txt
  include(CheckCXXSourceCompiles)

然后使用 check_cxx_compiles_source 测试 logexp 的可用性。此函数允许我们在真正的源代码编译前尝试使用所需依赖项编译简单代码。产生的变量 HAVE_LOGHAVE_EXP 表示这些依赖项是否可用。

TODO 2:单击显示/隐藏答案
TODO 2: MathFunctions/CMakeLists.txt
  check_cxx_source_compiles("
    #include <cmath>
    int main() {
      std::log(1.0);
      return 0;
    }
  " HAVE_LOG)
  check_cxx_source_compiles("
    #include <cmath>
    int main() {
      std::exp(1.0);
      return 0;
    }
  " HAVE_EXP)

接下来,我们需要将这些 CMake 变量传递给我们的源代码。这样,我们的源代码就可以知道有哪些资源可用。如果 logexp 均可用,则使用 target_compile_definitions()HAVE_LOGHAVE_EXP 指定为 PRIVATE 编译定义。

TODO 3:单击显示/隐藏答案
TODO 3: MathFunctions/CMakeLists.txt
  if(HAVE_LOG AND HAVE_EXP)
    target_compile_definitions(SqrtLibrary
                               PRIVATE "HAVE_LOG" "HAVE_EXP"
                               )
  endif()

  target_link_libraries(MathFunctions PRIVATE SqrtLibrary)
endif()

由于我们可能正在使用 logexp,因此我们需要修改 mysqrt.cxx 以包括 cmath

TODO 4:单击显示/隐藏答案
TODO 4: MathFunctions/mysqrt.cxx
#include <cmath>

如果系统中提供了 logexp,则使用它们在 mysqrt 函数中计算平方根。MathFunctions/mysqrt.cxx 中的 mysqrt 函数如下所示

TODO 5:点击显示/隐藏答案
TODO 5:MathFunctions/mysqrt.cxx
#if defined(HAVE_LOG) && defined(HAVE_EXP)
  double result = std::exp(std::log(x) * 0.5);
  std::cout << "Computing sqrt of " << x << " to be " << result
            << " using log and exp" << std::endl;
#else
  double result = x;

  // do ten iterations
  for (int i = 0; i < 10; ++i) {
    if (result <= 0) {
      result = 0.1;
    }
    double delta = x - (result * result);
    result = result + 0.5 * delta / result;
    std::cout << "Computing sqrt of " << x << " to be " << result << std::endl;
  }
#endif