Фильтр 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) - Этот фильтр в основном передает вызов функции
itertools.zip_longestPython
Примеры
# 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ansible/builtin/zip_longest_filter.html
