list

Операции со списками.

list(LENGTH <list> <output variable>)
list(GET <list> <element index> [<element index> ...]
     <output variable>)
list(APPEND <list> [<element> ...])
list(FILTER <list> <INCLUDE|EXCLUDE> REGEX <regular_expression>)
list(FIND <list> <value> <output variable>)
list(INSERT <list> <element_index> <element> [<element> ...])
list(REMOVE_ITEM <list> <value> [<value> ...])
list(REMOVE_AT <list> <index> [<index> ...])
list(REMOVE_DUPLICATES <list>)
list(REVERSE <list>)
list(SORT <list>)

LENGTH вернёт длину заданного списка.

GET вернёт список элементов, указанных индексами из списка.

APPEND добавит элементы в список.

FILTER добавит или удалит элементы из списка, соответствующие шаблону режима. В режиме REGEX элементы будут сопоставляться с заданным регулярным выражением. Для получения дополнительной информации о регулярных выражениях, см. также команду string().

FIND вернёт индекс элемента, указанного в списке, или -1, если он не был найден.

INSERT вставит элементы в список в указанное место.

REMOVE_AT и REMOVE_ITEM удалят элементы из списка. Разница в том, что REMOVE_ITEM удалит указанные элементы, а REMOVE_AT удалит элементы по указанным индексам.

REMOVE_DUPLICATES удалит дублирующиеся элементы в списке.

REVERSE инвертирует содержимое списка на месте.

SORT сортирует список на месте в алфавитном порядке.

Подкоманды списка APPEND, INSERT, FILTER, REMOVE_AT, REMOVE_ITEM, REMOVE_DUPLICATES, REVERSE и SORT могут создавать новые значения для списка в рамках текущей области видимости переменной CMake. Аналогично команде set(), команда LIST создаёт новые значения переменных в текущей области видимости, даже если сам список фактически определён в родительской области видимости. Для распространения результатов этих операций вверх используйте set() с PARENT_SCOPE, set() с CACHE INTERNAL, или другие средства распространения значений.

ПРИМЕЧАНИЯ: Список в cmake — это группа строк, разделённых ;. Для создания списка можно использовать команду set. Например, set(var a b c d e) создаёт список со значениями a;b;c;d;e, а set(var "a b c d e") создаёт строку или список с одним элементом. (Обратите внимание, что аргументы макросов не являются переменными и поэтому не могут использоваться в командах LIST.)

При указании значений индексов, если <element index> равно 0 или больше, индексация ведётся с начала списка, где 0 соответствует первому элементу списка. Если <element index> равно -1 или меньше, индексация ведётся с конца списка, где -1 соответствует последнему элементу списка. Будьте внимательны при подсчёте с отрицательными индексами: они не начинаются с 0. -0 эквивалентно 0, первому элементу списка.