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, первому элементу списка.