ansible.builtin.indexed_items (v2.16.5) — lookup

rewrites lists to return 'indexed items'

| "added in version" 1.3 of ansible.builtin"

Authors: Michael DeHaan

Install Ansible via pip

Install with pip install ansible-core==2.16.5

Description

use this lookup if you want to loop over an array and also get the numeric index of where you are in the array as you go

any list given will be transformed with each resulting element having the it's previous position in item.0 and its value in item.1

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: indexed loop demo
  ansible.builtin.debug:
    msg: "at array position {{ item.0 }} there is a value {{ item.1 }}"
  with_indexed_items:
    - "{{ some_list }}"

Inputs

    
_terms:
    description: list of items
    required: true

Outputs

_raw:
  description:
  - list with each item.0 giving you the position and item.1 the value
  elements: list
  type: list