Files
opentf/website/docs/configuration/functions/element.html.md
Martin Atkins e7d71995f6 website: Document the remaining "collection" functions
This also renames some of the existing function pages whose source
filenames were not matching the usual naming scheme (.html.md).
2018-10-16 18:47:33 -07:00

866 B

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
functions element function docs-funcs-collection-element The element function retrieves a single element from a list.

element Function

element retrieves a single element from a list.

element(list, index)

The index is zero-based. This function produces an error if used with an empty list.

Use the built-in index syntax list[index] in most cases. Use this function only for the special additional "wrap-around" behavior described below.

Examples

> element(["a", "b", "c"], 1)
b

If the given index is greater than the length of the list then the index is "wrapped around" by taking the index modulo the length of the list:

> element(["a", "b", "c"], 3)
a
  • index finds the index for a particular element value.