diff --git a/website/docs/configuration/functions/element.html.md b/website/docs/configuration/functions/element.html.md index f1b799137..63ac16e26 100644 --- a/website/docs/configuration/functions/element.html.md +++ b/website/docs/configuration/functions/element.html.md @@ -38,3 +38,4 @@ a ## Related Functions * [`index`](./index.html) finds the index for a particular element value. +* [`lookup`](./lookup.html) retrieves a value from a _map_ given its _key_. diff --git a/website/docs/configuration/functions/keys.html.md b/website/docs/configuration/functions/keys.html.md new file mode 100644 index 000000000..1d95e1ee3 --- /dev/null +++ b/website/docs/configuration/functions/keys.html.md @@ -0,0 +1,29 @@ +--- +layout: "functions" +page_title: "keys function" +sidebar_current: "docs-funcs-collection-keys" +description: |- + The keys function returns a list of the keys in a given map. +--- + +# `keys` Function + +`keys` takes a map and returns a list containing the keys from that map. + +The keys are returned in lexicographical order, ensuring that the result will +be identical as long as the keys in the map don't change. + +## Examples + +``` +> keys({a=1, c=2, d=3}) +[ + "a", + "c", + "d", +] +``` + +## Related Functions + +* [`values`](./values.html) returns a list of the _values_ from a map. diff --git a/website/docs/configuration/functions/lookup.html.md b/website/docs/configuration/functions/lookup.html.md new file mode 100644 index 000000000..5c2488303 --- /dev/null +++ b/website/docs/configuration/functions/lookup.html.md @@ -0,0 +1,33 @@ +--- +layout: "functions" +page_title: "lookup function" +sidebar_current: "docs-funcs-collection-lookup" +description: |- + The lookup function retrieves an element value from a map given its key. +--- + +# `lookup` Function + +`lookup` retrieves the value of a single element from a map, given its key. +If the given key does not exist, a the given default value is returned instead. + +``` +lookup(map, key, default) +``` + +-> For historical reasons, the `default` parameter is actually optional. However, +omitting `default` is deprecated since v0.7 because that would then be +equivalent to the native index syntax, `map[key]`. + +## Examples + +``` +> lookup({a="ay", b="bee"}, "a", "what?") +ay +> lookup({a="ay", b="bee"}, "c", "what?") +what? +``` + +## Related Functions + +* [`element`](./element.html) retrieves a value from a _list_ given its _index_. diff --git a/website/docs/configuration/functions/values.html.md b/website/docs/configuration/functions/values.html.md new file mode 100644 index 000000000..6c8c837a0 --- /dev/null +++ b/website/docs/configuration/functions/values.html.md @@ -0,0 +1,31 @@ +--- +layout: "functions" +page_title: "values function" +sidebar_current: "docs-funcs-collection-values" +description: |- + The values function returns a list of the element values in a given map. +--- + +# `values` Function + +`values` takes a map and returns a list containing the values of the elements +in that map. + +The values are returned in lexicographical order by their corresponding _keys_, +so the values will be returned in the same order as their keys would be +returned from [`keys`](./keys.html). + +## Examples + +``` +> values({a=3, c=2, d=1}) +[ + 3, + 2, + 1, +] +``` + +## Related Functions + +* [`keys`](./keys.html) returns a list of the _keys_ from a map. diff --git a/website/layouts/functions.erb b/website/layouts/functions.erb index 13470416d..b137b5542 100644 --- a/website/layouts/functions.erb +++ b/website/layouts/functions.erb @@ -143,6 +143,10 @@ index + > + keys + + > length @@ -151,6 +155,10 @@ list + > + lookup + + > map @@ -175,6 +183,10 @@ transpose + > + values + + > zipmap