> For the complete documentation index, see [llms.txt](https://conductor.js.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://conductor.js.org/1.3.0/api-reference/iterate.md).

# iterate

```erlang
iterate :: Iterable => () => Any value
```

## description

Returns a function which iterate over an [`Iterable`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterator_protocol) by calling its next method every time it is called. iterate is rarely useful by itself. However, it can be extremely useful when trying to iterate simultaneously over multiple iterables to combine them.

## examples

### basic example

```javascript
import { iterate } from 'conductor'

const array = [2, 4]
const iterator = iterate(array)
iterator() // 2
iterator() // 4
iterator() // undefined
```

Here, we simply get an `Iterator` from an array by calling `iterate` on it. Each call to the iterator will return the value of the next item in the `Iterable`.

### iterating simultaneously over two collections

```javascript
import { filter, iterate } 'conductor'

const characters = ['Luke', 'Han', 'Darth Vader']
const isGood = [true, true, false]
const predicate = iterate(isGood)

filter(predicate, characters) // ['Luke', 'Han']
```

Let's say we have an array of characters, `characters`, and another one, `isGood`, which indicates if each character is indeed good. We need to filter the characters to keep only the good guys, so we need to iterate simultaneously over the two collections. Let's get an `Iterator` out of our `isGood` array by calling `iterate` on it. This will be our predicate function: each time it will be called by `filter` while iterating over our `characters` array, it will return the next value from `isGood`, indicating if the current character is one the good guys.