2.3 处理与编译器相关的源代码

NOTE:此示例代码可以在 https://github.com/dev-cafe/cmake-cookbook/tree/v1.0/chapter-02/recipe-03 中找到，包含一个C++和Fortran示例。该示例在CMake 3.5版(或更高版本)中是有效的，并且已经在GNU/Linux、macOS和Windows上进行过测试。

这个方法与前面的方法类似，我们将使用CMake来编译依赖于环境的条件源代码：本例将依赖于编译器。为了可移植性，我们尽量避免去编写新代码，但遇到有依赖的情况我们也要去解决，特别是当使用历史代码或处理编译器依赖工具，如sanitizers。从这一章和前一章的示例中，我们已经掌握了实现这一目标的所有方法。尽管如此，讨论与编译器相关的源代码的处理问题还是很有用的，这样我们将有机会从另一方面了解CMake。

准备工作

本示例中，我们将从C++中的一个示例开始，稍后我们将演示一个Fortran示例，并尝试重构和简化CMake代码。

看一下hello-world.cpp源代码:

  1. #include <cstdlib>
  2. #include <iostream>
  3. #include <string>
  5. std::string say_hello() {
  6. #ifdef IS_INTEL_CXX_COMPILER
  7.   // only compiled when Intel compiler is selected
  8.   // such compiler will not compile the other branches
  9.   return std::string("Hello Intel compiler!");
  10. #elif IS_GNU_CXX_COMPILER
  11.   // only compiled when GNU compiler is selected
  12.   // such compiler will not compile the other branches
  13.   return std::string("Hello GNU compiler!");
  14. #elif IS_PGI_CXX_COMPILER
  15.   // etc.
  16.   return std::string("Hello PGI compiler!");
  17. #elif IS_XL_CXX_COMPILER
  18.   return std::string("Hello XL compiler!");
  19. #else
  20.   return std::string("Hello unknown compiler - have we met before?");
  21. #endif
  22. }
  24. int main() {
  25.   std::cout << say_hello() << std::endl;
  26.   std::cout << "compiler name is " COMPILER_NAME << std::endl;
  27.   return EXIT_SUCCESS;
  28. }

Fortran示例(hello-world.F90):

  1. program hello
  3.   implicit none
  4. #ifdef IS_Intel_FORTRAN_COMPILER
  5.   print *, 'Hello Intel compiler!'
  6. #elif IS_GNU_FORTRAN_COMPILER
  7.   print *, 'Hello GNU compiler!'
  8. #elif IS_PGI_FORTRAN_COMPILER
  9.   print *, 'Hello PGI compiler!'
  10. #elif IS_XL_FORTRAN_COMPILER
  11.   print *, 'Hello XL compiler!'
  12. #else
  13.   print *, 'Hello unknown compiler - have we met before?'
  14. #endif
  16. end program

具体实施

我们将从C++的例子开始，然后再看Fortran的例子:

  1. CMakeLists.txt文件中，定义了CMake最低版本、项目名称和支持的语言:

    1. cmake_minimum_required(VERSION 3.5 FATAL_ERROR)
    2. project(recipe-03 LANGUAGES CXX)

  2. 然后，定义可执行目标及其对应的源文件:

    1. add_executable(hello-world hello-world.cpp)

  3. 通过定义以下目标编译定义，让预处理器了解编译器的名称和供应商:

    1. target_compile_definitions(hello-world PUBLIC "COMPILER_NAME=\"${CMAKE_CXX_COMPILER_ID}\"")
    3. if(CMAKE_CXX_COMPILER_ID MATCHES Intel)
    4.   target_compile_definitions(hello-world PUBLIC "IS_INTEL_CXX_COMPILER")
    5. endif()
    6. if(CMAKE_CXX_COMPILER_ID MATCHES GNU)
    7.   target_compile_definitions(hello-world PUBLIC "IS_GNU_CXX_COMPILER")
    8. endif()
    9. if(CMAKE_CXX_COMPILER_ID MATCHES PGI)
    10.   target_compile_definitions(hello-world PUBLIC "IS_PGI_CXX_COMPILER")
    11. endif()
    12. if(CMAKE_CXX_COMPILER_ID MATCHES XL)
    13.   target_compile_definitions(hello-world PUBLIC "IS_XL_CXX_COMPILER")
    14. endif()

现在我们已经可以预测结果了:

  1. $ mkdir -p build
  2. $ cd build
  3. $ cmake ..
  4. $ cmake --build .
  5. $ ./hello-world
  7. Hello GNU compiler!

使用不同的编译器，此示例代码将打印不同的问候语。

前一个示例的CMakeLists.txt文件中的if语句似乎是重复的，我们不喜欢重复的语句。能更简洁地表达吗？当然可以！为此，让我们再来看看Fortran示例。

Fortran例子的CMakeLists.txt文件中，我们需要做以下工作:

  1. 需要使Fortran语言:

    1. project(recipe-03 LANGUAGES Fortran)

  2. 然后，定义可执行文件及其对应的源文件。在本例中，使用大写.F90后缀:

    1. add_executable(hello-world hello-world.F90)

  3. 我们通过定义下面的目标编译定义，让预处理器非常清楚地了解编译器:

    1. target_compile_definitions(hello-world
    2.   PUBLIC "IS_${CMAKE_Fortran_COMPILER_ID}_FORTRAN_COMPILER"
    3.   )

其余行为与C++示例相同。

工作原理

CMakeLists.txt会在配置时，进行预处理定义，并传递给预处理器。Fortran示例包含非常紧凑的表达式，我们使用CMAKE_Fortran_COMPILER_ID变量，通过target_compile_definition使用构造预处理器进行预处理定义。为了适应这种情况，我们必须将”Intel”从IS_INTEL_CXX_COMPILER更改为IS_Intel_FORTRAN_COMPILER。通过使用相应的CMAKE_C_COMPILER_ID和CMAKE_CXX_COMPILER_ID变量，我们可以在C或C++中实现相同的效果。但是，请注意，CMAKE_<LANG>_COMPILER_ID不能保证为所有编译器或语言都定义。

NOTE:对于应该预处理的Fortran代码使用.F90后缀，对于不需要预处理的代码使用.f90后缀。