You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
packer/website/content/docs/templates/hcl_templates/functions/collection/slice.mdx

37 lines
1.3 KiB

---
page_title: slice function reference
description: The `slice` function extracts consecutive elements from a list. Learn how to use the `slice` function in Packer templates.
---
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
# `slice` Function
`slice` extracts some consecutive elements from within a list.
```hcl
slice(list, startindex, endindex)
```
`startindex` is inclusive, while `endindex` is exclusive. This function returns
an error if either index is outside the bounds of valid indices for the given
list.
## Examples
```shell-session
> slice(["a", "b", "c", "d"], 1, 3)
[
"b",
"c",
]
```
## Related Functions
- [`substr`](/packer/docs/templates/hcl_templates/functions/string/substr) performs a similar function for characters in a
string, although it uses a length instead of an end index.