CMakeDependentOption
Макрос для предоставления параметра, зависящего от других параметров.
Этот макрос предоставляет параметр пользователю только если набор других условий верен.
-
cmake_dependent_option -
cmake_dependent_option(<option> "<help_text>" <value> <depends> <force>)
Делает
<option>доступным для пользователя, если список условий, разделённых точкой с запятой, в<depends>, все верны. В противном случае, локальная переменная с именем<option>устанавливается в значение<force>.Когда
<option>доступен, заданное значение<help_text>и начальное значение<value>используются. В противном случае, любое значение, заданное пользователем, сохраняется до тех пор, пока<depends>не будет удовлетворено в будущем.Обратите внимание, что переменная
<option>имеет значение, которое удовлетворяет условию<depends>только в пределах области вызывающего кода, поскольку это локальная переменная.
Пример вызова:
cmake_dependent_option(USE_FOO "Use Foo" ON "USE_BAR;NOT USE_ZOT" OFF)
Если USE_BAR истинно, а USE_ZOT ложно, это предоставляет параметр с именем USE_FOO, значение которого по умолчанию ON. В противном случае, оно устанавливает USE_FOO в значение OFF и скрывает параметр от пользователя. Если статус USE_BAR или USE_ZOT когда-либо изменится, любое значение параметра USE_FOO сохраняется, чтобы при повторном включении параметра он сохранил свое старое значение.
Новое в версии 3.22: Теперь поддерживается полная Синтаксис условия. См. политику CMP0127.
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.29/module/CMakeDependentOption.html