From cf251f6b291ae4f02e16ebb7f318a58f393db9ca Mon Sep 17 00:00:00 2001 From: Florent Planque Date: Tue, 18 Mar 2025 16:17:00 +0100 Subject: [PATCH] fix element function documentation --- website/docs/language/functions/element.mdx | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/website/docs/language/functions/element.mdx b/website/docs/language/functions/element.mdx index 06e89f8332..49d8039a7e 100644 --- a/website/docs/language/functions/element.mdx +++ b/website/docs/language/functions/element.mdx @@ -12,7 +12,7 @@ element(list, index) ``` The index is zero-based. This function produces an error if used with an -empty list. The index must be a non-negative integer. +empty list. The index can be a negative integer. Use the built-in index syntax `list[index]` in most cases. Use this function only for the special additional "wrap-around" behavior described below. @@ -21,7 +21,7 @@ only for the special additional "wrap-around" behavior described below. ``` > element(["a", "b", "c"], 1) -b +"b" ``` If the given index is greater than the length of the list then the index is @@ -29,16 +29,14 @@ If the given index is greater than the length of the list then the index is ``` > element(["a", "b", "c"], 3) -a +"a" ``` -To get the last element from the list use [`length`](/terraform/language/functions/length) to find -the size of the list (minus 1 as the list is zero-based) and then pick the -last element: +To get the last element from the list use the index `-1`: ``` -> element(["a", "b", "c"], length(["a", "b", "c"])-1) -c +> element(["a", "b", "c"], -1) +"c" ``` ## Related Functions