37 lines
784 B
Markdown
37 lines
784 B
Markdown
---
|
|
layout: "functions"
|
|
page_title: "tomap - Functions - Configuration Language"
|
|
sidebar_current: "docs-funcs-conversion-tomap"
|
|
description: |-
|
|
The tomap function converts a value to a map.
|
|
---
|
|
|
|
# `tomap` Function
|
|
|
|
`tomap` converts its argument to a map value.
|
|
|
|
Explicit type conversions are rarely necessary in Terraform because it will
|
|
convert types automatically where required. Use the explicit type conversion
|
|
functions only to normalize types returned in module outputs.
|
|
|
|
## Examples
|
|
|
|
```
|
|
> tomap({"a" = 1, "b" = 2})
|
|
{
|
|
"a" = 1
|
|
"b" = 2
|
|
}
|
|
```
|
|
|
|
Since Terraform's concept of a map requires all of the elements to be of the
|
|
same type, mixed-typed elements will be converted to the most general type:
|
|
|
|
```
|
|
> tomap({"a" = "foo", "b" = true})
|
|
{
|
|
"a" = "foo"
|
|
"b" = "true"
|
|
}
|
|
```
|