基本语法
########################################

在学习 cmake 之前，首先需要了解 cmake 的约定和基础语法

基本约定
****************************************

- cmake 的文件名为 ``CMakeLists.txt`` 。该文件名大小写敏感，且不能更改
- cmake 的语句应当为小写
- cmake 自带的宏应当全大写
- 自行设置的变量名应当小写

数据类型、循环和条件语句
****************************************

cmake 中的行注释为 ``#`` ，其用法与 C++ 中的 ``//`` 完全相同

.. note::

    使用 ``message(变量名或字符串)`` 可以向控制台输出信息

数据类型
****************************************

对于 cmake 来说，数据类型只有三种： ``字符串`` 、``布尔值`` 和 ``列表``。
要设置一个变量，可以通过 ``set(变量名 ...)`` 的方式，要访问一个变量，可以直接使用 ``${变量名}`` 的方式

.. note::

    使用 ``$变量名`` 也可以访问变量，但是在拼接字符串时会导致解析变量名错误，因此极度不推荐。

字符串
========================================


要设置一个 ``字符串`` ，使用 ``set(变量名 字符串)`` 的方式。

- cmake 中的字符串无需加单引号或双引号（也不能加）
- 要拼接字符串，可以直接加到变量名后，例如：
    .. code-block:: cmake

        set(var1 hello)
        message(${var1}world) # 输出结果为 helloworld
- 字符串中间的空格将被忽略

例如：

.. code-block:: cmake

    set(var1 sd) # 相当于 C++ 中的 ``string var1 = "sd"``

布尔值
========================================

要设置一个 ``布尔值`` ， 使用 ``set(变量名 布尔值)`` 的方式。

- 以下布尔值为真：1、ON、YES、Y、TURE。
- 以下布尔值为假：0、OFF、NO、N、FALSE、IGNORE、NOTFOUND、空值、以 ``-NOTFOUND`` 为后缀的变量名

.. important::
    - ``''`` 、``""`` 在C++中被认为是 false，但是在 cmake 中被认为是字符串，为真值
    - 以 ``-NOTFOUND`` 为后缀的变量名永远为假
    - 使用 ``NOT`` 可以对变量取反

列表
========================================

要设置一个 ``列表`` ， 使用 ``list(操作方式 变量名 字符串)`` 的方式。
例如：

.. code-block:: cmake

    list(APPEND var ss ss)

.. note::

    使用 ``set(变量名 值1 值2 值3)`` 得到的也是列表

.. seealso::

   - \ `Cmake中的list <https://www.cnblogs.com/laozhuang/p/7365510.html>`_


条件语句
****************************************

cmake 使用 ``if() elseif() else() endif()`` 控制整个条件语句

例如：

.. code-block:: cpp

    if(true)
        message(true)
    elseif(false)
        message(false)
    endif()

.. note::

    else() 和 endif() 用于指定指令的作用域

循环
****************************************

cmake有两种控制循环的方式：

#. foreach endforeach
#. while endwhile

使用 ``break`` 可以跳出循环

例如：

.. code-block:: cmake

    list(APPEND var h e w o r d)

    foreach(_li ${var})
        message(${_li})
    endforeach()

输出结果为
    h
    e
    w
    o
    r
    d