cmake_parse_arguments

cmake_parse_arguments предназначен для использования в макросах или функциях для анализа аргументов, переданных этому макросу или функции. Он обрабатывает аргументы и определяет набор переменных, которые хранят значения соответствующих опций.

cmake_parse_arguments(<prefix> <options> <one_value_keywords>
                      <multi_value_keywords> args...)

cmake_parse_arguments(PARSE_ARGV N <prefix> <options> <one_value_keywords>
                      <multi_value_keywords>)

Первый вариант обрабатывает аргументы, переданные в args.... Это можно использовать как в macro(), так и в function().

Вариант PARSE_ARGV предназначен только для использования в теле function(). В этом случае аргументы, которые анализируются, берутся из переменных ARGV# вызывающей функции. Анализ начинается с N-го аргумента, где N — целое без знака. Это позволяет значениям содержать специальные символы, такие как ;.

Аргумент <options> содержит все опции для соответствующего макроса, т.е. ключевые слова, которые можно использовать при вызове макроса без значения, следующего за ним, например, ключевое слово OPTIONAL команды install().

Аргумент <one_value_keywords> содержит все ключевые слова для этого макроса, за которыми следует одно значение, например, ключевое слово DESTINATION команды install().

Аргумент <multi_value_keywords> содержит все ключевые слова для этого макроса, за которыми могут следовать более одного значения, например, ключевые слова TARGETS или FILES команды install().

После завершения cmake_parse_arguments будет определена переменная для каждого из ключевых слов, перечисленных в <options>, <one_value_keywords> и <multi_value_keywords>, которая состоит из заданного <prefix> и имени соответствующего ключевого слова. Эти переменные будут хранить соответствующее значение из списка аргументов. Для ключевых слов <options> это будет TRUE или FALSE.

Все оставшиеся аргументы собираются в переменной <prefix>_UNPARSED_ARGUMENTS, что позволяет проверить, был ли ваш макрос вызван с нераспознанными параметрами.

В качестве примера здесь представлен макрос my_install(), который принимает аргументы, аналогичные аргументам реальной команды install():

function(MY_INSTALL)
    set(options OPTIONAL FAST)
    set(oneValueArgs DESTINATION RENAME)
    set(multiValueArgs TARGETS CONFIGURATIONS)
    cmake_parse_arguments(MY_INSTALL "${options}" "${oneValueArgs}"
                          "${multiValueArgs}" ${ARGN} )

    # ...

Предположим, my_install() был вызван следующим образом:

my_install(TARGETS foo bar DESTINATION bin OPTIONAL blub)

После вызова cmake_parse_arguments макрос установит следующие переменные:

MY_INSTALL_OPTIONAL = TRUE
MY_INSTALL_FAST = FALSE (was not used in call to my_install)
MY_INSTALL_DESTINATION = "bin"
MY_INSTALL_RENAME = "" (was not used)
MY_INSTALL_TARGETS = "foo;bar"
MY_INSTALL_CONFIGURATIONS = "" (was not used)
MY_INSTALL_UNPARSED_ARGUMENTS = "blub" (nothing expected after "OPTIONAL")

Затем вы можете продолжить и обработать эти переменные.

Ключевые слова завершают списки значений, например, если сразу после one_value_keyword следует другое распознанное ключевое слово, это интерпретируется как начало новой опции. Например, my_install(TARGETS foo DESTINATION OPTIONAL) приведет к тому, что MY_INSTALL_DESTINATION будет установлено в "OPTIONAL", но так как OPTIONAL само является ключевым словом, MY_INSTALL_DESTINATION будет пустым, и поэтому MY_INSTALL_OPTIONAL будет установлено в TRUE.