diff options
Diffstat (limited to 'lib/ansible/plugins/filter/intersect.yml')
-rw-r--r-- | lib/ansible/plugins/filter/intersect.yml | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/intersect.yml b/lib/ansible/plugins/filter/intersect.yml new file mode 100644 index 0000000..d811eca --- /dev/null +++ b/lib/ansible/plugins/filter/intersect.yml @@ -0,0 +1,35 @@ +DOCUMENTATION: + name: intersect + author: Brian Coca (@bcoca) + version_added: "1.4" + short_description: intersection of lists + description: + - Provide a list with the common elements from other lists. + options: + _input: + description: A list. + type: list + required: true + _second_list: + description: A list. + type: list + required: true + seealso: + - plugin_type: filter + plugin: ansible.builtin.difference + - plugin_type: filter + plugin: ansible.builtin.symmetric_difference + - plugin_type: filter + plugin: ansible.builtin.unique + - plugin_type: filter + plugin: ansible.builtin.union +EXAMPLES: | + # return only the common elements of list1 and list2 + # list1: [1, 2, 5, 3, 4, 10] + # list2: [1, 2, 3, 4, 5, 11, 99] + {{ list1 | intersect(list2) }} + # => [1, 2, 5, 3, 4] +RETURN: + _value: + description: A list with unique elements common to both lists, also known as a set. + type: list |