ansible.builtin.zip_longest фильтр – объединение элементов списка с заполнителем
Примечание
Этот плагин фильтра является частью ansible-core и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя плагина zip_longest. Однако мы рекомендуем использовать полное имя коллекции (FQCN) ansible.builtin.zip_longest для удобной ссылки на документацию по плагину и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя плагина фильтра.
- Синтаксис
- Входные данные
- Позиционные параметры
- Параметры ключевых слов
- Примечания
- Примеры
- Возвращаемое значение
Синтаксис
- Создаёт итератор, который агрегирует элементы из каждого из итерируемых объектов. Если итерируемые объекты имеют разную длину, отсутствующие значения заполняются
fillvalue. Итерация продолжается до тех пор, пока самый длинный итерируемый объект не будет исчерпан.
Входные данные
Это описание входных данных фильтра, значения до | ansible.builtin.zip_longest.
Параметр |
Комментарии |
|---|---|
Входные данные список / элементы=любой / обязательный |
Исходный список. |
Позиционные параметры
Это описание позиционных параметров фильтра. Это значения positional1, positional2 и так далее в следующем примере: input | ansible.builtin.zip_longest(positional1, positional2, ...).
Параметр |
Комментарии |
|---|---|
_additional_lists список / элементы=любой / обязательный |
Дополнительные списки. |
Параметры ключевых слов
Это описание параметров ключевых слов фильтра. Это значения key1=value1, key2=value2 и так далее в следующем примере: input | ansible.builtin.zip_longest(key1=value1, key2=value2, ...).
Параметр |
Комментарии |
|---|---|
fillvalue любой |
Значение заполнителя для добавления в вывод, когда один из списков не содержит достаточно элементов для соответствия другим. |
Примечания
Примечание
- При совместном использовании параметров ключевых слов и позиционных параметров позиционные параметры должны быть перечислены до параметров ключевых слов:
input | ansible.builtin.zip_longest(positional1, positional2, key1=value1, key2=value2) - В основном это проброс функции Python
itertools.zip_longest.
Примеры
# X_fill => [[1, "a", 21], [2, "b", 22], [3, "c", 23], ["X", "d", "X"], ["X", "e", "X"], ["X", "f", "X"]]
X_fill: "{{ [1,2,3] | zip_longest(['a','b','c','d','e','f'], [21, 22, 23], fillvalue='X') }}"
Возвращаемое значение
Ключ |
Описание |
|---|---|
Возвращаемое значение список / элементы=список |
Список списков, состоящих из элементов, соответствующих позициям входных списков. Возвращено: успех |
Подсказка
Параметры конфигурации для каждого типа записи имеют порядок приоритета снизу вверх. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ansible/builtin/zip_longest_filter.html
