2018-05-12 18:39:29 +02:00
|
|
|
---
|
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "index - Functions - Configuration Language"
|
2018-05-12 18:39:29 +02:00
|
|
|
sidebar_current: "docs-funcs-collection-index"
|
|
|
|
|
description: |-
|
|
|
|
|
The index function finds the element index for a given value in a list.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# `index` Function
|
|
|
|
|
|
|
|
|
|
`index` finds the element index for a given value in a list.
|
|
|
|
|
|
|
|
|
|
```hcl
|
|
|
|
|
index(list, value)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The returned index is zero-based. This function produces an error if the given
|
|
|
|
|
value is not present in the list.
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
> index(["a", "b", "c"], "b")
|
|
|
|
|
1
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Related Functions
|
|
|
|
|
|
|
|
|
|
* [`element`](./element.html) retrieves a particular element from a list given
|
|
|
|
|
its index.
|
