terraform/website/docs/configuration/functions
Martin Atkins ae3c0c6a4a lang/funcs: Remove the deprecated "list" and "map" functions
Prior to Terraform 0.12 these two functions were the only way to construct
literal lists and maps (respectively) in HIL expressions. Terraform 0.12,
by switching to HCL 2, introduced first-class syntax for constructing
tuple and object values, which can then be converted into list and map
values using the tolist and tomap type conversion functions.

We marked both of these functions as deprecated in the Terraform v0.12
release and have since then mentioned in the docs that they will be
removed in a future Terraform version. The "terraform 0.12upgrade" tool
from Terraform v0.12 also included a rule to automatically rewrite uses
of these functions into equivalent new syntax.

The main motivation for removing these now is just to get this change made
prior to Terraform 1.0. as we'll be doing with various other deprecations.
However, a specific reason for these two functions in particular is that
their existence is what caused us to invent the idea of a "type expression"
as a distinct kind of expression in Terraform v0.12, and so removing them
now would allow potentially  unifying type expressions with value
expressions in a future release.

We do not have any current specific plans to make that change, but one
potential motivation for doing so would be to take another attempt at a
generalized "convert" function which takes a type as one of its arguments.
Our previous attempt to implement such a function was foiled by the fact
that Terraform's expression validator doesn't have any way to know to
treat one argument of a particular function as special, and so it was
generating incorrect error messages. We won't necessarily do that, but
having these "list" and "map" functions out of the way leaves the option
open.
2020-11-04 17:05:59 -08:00
..
abs.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
abspath.html.md lang/funcs: add "abspath" function (#21409) 2019-07-02 08:30:30 -04:00
alltrue.html.md lang/funcs: Add "alltrue" function (#25656) 2020-09-22 09:06:42 -04:00
anytrue.html.md lang/funcs: "anytrue" function 2020-10-23 13:52:48 -07:00
base64decode.html.md lang/funcs: Rename the base64 character encoding functions 2020-10-21 10:56:56 -07:00
base64encode.html.md lang/funcs: Rename the base64 character encoding functions 2020-10-21 10:56:56 -07:00
base64gzip.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
base64sha256.html.md website: Fix typographical errors in the docs for base64sha256/512 2019-11-08 09:43:27 -08:00
base64sha512.html.md website: Fix typographical errors in the docs for base64sha256/512 2019-11-08 09:43:27 -08:00
basename.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
bcrypt.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
can.html.md configs: Custom variable validation is no longer experimental 2020-05-28 16:07:59 -07:00
ceil.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
chomp.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
chunklist.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
cidrhost.html.md website: Additional explanation for cidrsubnet function 2019-03-26 10:04:29 -07:00
cidrnetmask.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
cidrsubnet.html.md lang/funcs: cidrsubnets function 2019-09-20 15:58:01 -07:00
cidrsubnets.html.md website/docs: Corrects function name in `cidrsubnets` function documentation (#23473) 2019-11-26 07:50:32 -05:00
coalesce.html.md funcs/coalesce: return the first non-null, non-empty-string element from a sequence (#21002) 2019-04-12 13:57:52 -04:00
coalescelist.html.md lang/funcs: add acc tests for functions (#21112) 2019-04-29 13:11:28 -04:00
compact.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
concat.html.md lang/funcs: add acc tests for functions (#21112) 2019-04-29 13:11:28 -04:00
contains.html.md lang/funcs: remove sethaselement function and documentation (#21164) 2019-05-02 10:47:19 -04:00
csvdecode.html.md website: example of csvdecode with for_each 2019-07-31 12:43:16 -07:00
dirname.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
distinct.html.md website: Fix several spelling errors 2019-03-21 18:12:11 -07:00
element.html.md Typo fix 2020-10-30 17:42:40 -07:00
file.html.md website: Typo in link to the templatefile function page 2019-03-15 14:12:26 -07:00
filebase64.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
filebase64sha256.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
filebase64sha512.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
fileexists.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
filemd5.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
fileset.html.md lang/funcs: Switch fileset() function glob implementation to github.com/bmatcuk/doublestar to support additional glob patterns 2019-08-30 20:22:03 -04:00
filesha1.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
filesha256.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
filesha512.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
flatten.html.md docs(flatten): Fix typos (#24492) 2020-04-10 08:59:17 -04:00
floor.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
format.html.md website/docs: document difference in formatting strings with width and precision (#25499) 2020-07-07 14:09:39 -04:00
formatdate.html.md Fix docs mistake/misleading 2019-08-28 11:38:26 -04:00
formatlist.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
indent.html.md Fix documentation example for the indent function 2020-08-10 11:45:28 +02:00
index.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
join.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
jsondecode.html.md website: Fix some broken links 2019-02-28 16:21:09 -08:00
jsonencode.html.md website: Document jsonencode entity escaping 2020-09-04 09:18:52 -04:00
keys.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
length.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
list.html.md lang/funcs: Remove the deprecated "list" and "map" functions 2020-11-04 17:05:59 -08:00
log.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
lookup.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
lower.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
map.html.md lang/funcs: Remove the deprecated "list" and "map" functions 2020-11-04 17:05:59 -08:00
matchkeys.html.md website: correct the title of the "matchkeys" function page 2019-04-04 15:35:13 -07:00
max.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
md5.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
merge.html.md doc typo 2020-02-13 21:27:35 -05:00
min.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
parseint.html.md lang/funcs: parseint function 2019-09-17 15:33:22 -07:00
pathexpand.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
pow.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
range.html.md website/docs: Updated documentation for range function pseudocode (#23823) 2020-01-13 09:17:47 -05:00
regex.html.md lang: "regex" and "regexall" functions 2019-08-06 11:52:14 -07:00
regexall.html.md lang: "regex" and "regexall" functions 2019-08-06 11:52:14 -07:00
replace.html.md lang: "regex" and "regexall" functions 2019-08-06 11:52:14 -07:00
reverse.html.md lang/funcs: add 'strrev' interpolation function. (#21091) 2019-04-24 14:52:39 -04:00
rsadecrypt.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
setintersection.html.md lang: add setsubtract function (#23424) 2020-02-06 12:49:11 -05:00
setproduct.html.md Typo: heirarchical => hierarchical 2020-07-23 15:09:22 +02:00
setsubtract.html.md lang: add setsubtract function (#23424) 2020-02-06 12:49:11 -05:00
setunion.html.md lang: add setsubtract function (#23424) 2020-02-06 12:49:11 -05:00
sha1.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
sha256.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
sha512.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
signum.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
slice.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
sort.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
split.html.md website: Fix several spelling errors 2019-03-21 18:12:11 -07:00
strrev.html.md lang/funcs: add 'strrev' interpolation function. (#21091) 2019-04-24 14:52:39 -04:00
substr.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
sum.html.md Feature: Sum Function (#24666) 2020-04-15 14:27:06 -04:00
templatefile.html.md Merge pull request #26314 from hashicorp/remove-template-provider-link 2020-09-30 17:57:02 -04:00
textdecodebase64.html.md lang/funcs: Rename the base64 character encoding functions 2020-10-21 10:56:56 -07:00
textencodebase64.html.md lang/funcs: Rename the base64 character encoding functions 2020-10-21 10:56:56 -07:00
timeadd.html.md website: Added missing doublequotes. (#20696) 2019-03-19 11:23:24 -07:00
timestamp.html.md docs/function/timestamp: Mention Time Provider (#26232) 2020-09-14 16:40:36 -04:00
title.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
tobool.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
tolist.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
tomap.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
tonumber.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
toset.html.md website: Fix various typos in the config function documentation 2019-03-11 13:59:12 -07:00
tostring.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
transpose.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
trim.html.md lang/funcs: Add more `trim*` functions (#23016) 2019-11-18 08:31:44 -05:00
trimprefix.html.md what happens when prefix is not in string 2020-06-22 11:31:08 -07:00
trimspace.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
trimsuffix.html.md lang/funcs: Add more `trim*` functions (#23016) 2019-11-18 08:31:44 -05:00
try.html.md fix yamldecode()-example, missing a file() call 2020-06-16 09:56:03 +02:00
upper.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
urlencode.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
uuid.html.md lang/funcs: New "uuidv5" function 2019-06-07 14:38:22 -07:00
uuidv5.html.md docs: Minor spelling and typo fixes 2019-09-05 10:08:34 -07:00
values.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00
yamldecode.html.md lang: yamldecode and yamlencode functions 2019-06-04 16:24:09 -07:00
yamlencode.html.md lang: yamldecode and yamlencode functions 2019-06-04 16:24:09 -07:00
zipmap.html.md website: Version notes: Add new -> old links to 0.12 language docs (function pages) 2019-02-01 17:20:54 -08:00