Type conversion functions in Terraform - Step-by-Step Execution

Process Flow - Type conversion functions

Start with a value

↓

Choose conversion function

↓

Apply function to value

↓

Get converted value

↓

Use converted value in config

Terraform takes a value, applies a type conversion function, and produces a new value in the desired type for use in configuration.

Execution Sample

Terraform

variable "num_str" {
  default = "123"
}

output "num_int" {
  value = tonumber(var.num_str)
}

Converts a string "123" to a number 123 using tonumber function.

Process Table

Step	Input Value	Function Applied	Result	Notes
1	"123"	tonumber	123	String '123' converted to number 123
2	123	tostring	"123"	Number 123 converted back to string '123'
3	["a", "b"]	toset	set("a", "b")	List converted to set to remove duplicates
4	set("a", "b")	tolist	["a", "b"]	Set converted back to list
5	"true"	bool	true	String 'true' converted to boolean true
6	"notabool"	bool	error	Invalid string for bool conversion causes error
7	123	bool	error	Number to bool conversion invalid, error
8	exit			Stop: no more conversions

💡 All conversions done or error encountered, execution stops.

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5	After Step 6	After Step 7	Final
value	"123"	123	"123"	set("a", "b")	["a", "b"]	true	error	error	error or final state

Key Moments - 3 Insights

Why does tonumber("123") work but bool("123") causes an error?

tonumber converts numeric strings to numbers successfully (see Step 1), but bool only accepts "true" or "false" strings; "123" is invalid for bool (see Step 7).

What happens when converting a list to a set and back?

Converting list ["a", "b"] to set removes duplicates and changes type (Step 3), then tolist converts it back to list (Step 4), preserving elements but changing type.

Why does bool("notabool") cause an error?

bool conversion only accepts "true" or "false" strings; "notabool" is invalid and causes an error (Step 6).

Visual Quiz - 3 Questions

Look at the execution table, what is the result of tonumber("123") at Step 1?

A "123"

B error

C 123

D true

💡 Hint

Check Step 1 in the execution_table under Result column.

At which step does converting a list to a set happen?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Look for 'List converted to set' note in execution_table.

If you try bool("false"), what would the execution table show?

A false

B true

C error

D "false"

💡 Hint

Refer to Step 5 where bool("true") converts to true; similarly, bool("false") converts to false.

Concept Snapshot

Terraform type conversion functions:
- tonumber(string) converts string to number
- tostring(value) converts value to string
- toset(list) converts list to set (unique elements)
- tolist(set) converts set back to list
- bool(string) converts "true"/"false" strings to boolean
- Invalid conversions cause errors
Use these to ensure correct types in configs.

Full Transcript

This visual execution shows how Terraform converts values between types using functions like tonumber, tostring, toset, tolist, and bool. Starting with a string "123", tonumber converts it to number 123. Then tostring converts it back to string. Lists can be converted to sets to remove duplicates and back to lists. Boolean conversion accepts only "true" or "false" strings; invalid inputs cause errors. The execution table tracks each step's input, function, and result. Variable tracking shows how the value changes after each conversion. Key moments clarify why some conversions fail and how list-set conversions work. The quiz tests understanding of these steps. This helps beginners see exactly how Terraform changes data types in configuration.

Practice

1. What does the Terraform function tostring() do?

easy

A. Converts a string to a number

B. Converts a value to a string type

C. Converts a list to a set

D. Converts a number to a boolean

Solution

1. Step 1: Understand the function purpose

   The tostring() function is designed to convert any given value into a string representation.

2. Step 2: Match function to output type

   Since it converts values to strings, it does not convert to numbers, sets, or booleans.

3. Final Answer:

   Converts a value to a string type -> Option B

4. Quick Check:

   tostring() = string [OK]

Hint: tostring() always outputs text format [OK]

Common Mistakes:

• Confusing tostring() with tonumber()
• Thinking tostring() converts to lists or sets
• Assuming tostring() changes boolean values

2. Which of the following is the correct syntax to convert a string "123" to a number in Terraform?

easy

A. tonumber("123")

B. tostring(123)

C. tolist("123")

D. toset("123")

Solution

1. Step 1: Identify the function for string to number conversion

   The function tonumber() converts strings that represent numbers into numeric types.

2. Step 2: Check syntax correctness

   The syntax tonumber("123") correctly converts the string "123" to the number 123.

3. Final Answer:

   tonumber("123") -> Option A

4. Quick Check:

   tonumber("123") = 123 [OK]

Hint: Use tonumber() to convert numeric strings to numbers [OK]

Common Mistakes:

• Using tostring() instead of tonumber()
• Trying to convert string to list or set incorrectly
• Missing quotes around the string input

3. What is the output of this Terraform expression?

tolist({"a" = 1, "b" = 2})

medium

A. Error: invalid argument

B. [1, 2]

C. ["a", "b"]

D. [{"a" = 1}, {"b" = 2}]

Solution

1. Step 1: Understand input type for tolist()

   The input is a map {"a" = 1, "b" = 2}, but tolist() expects a tuple or list, not a map.

2. Step 2: Check if conversion is valid

   Converting a map directly to a list using tolist() causes an error because the types are incompatible.

3. Final Answer:

   Error: invalid argument -> Option A

4. Quick Check:

   tolist() on map = error [OK]

Hint: tolist() needs list or tuple input, not maps [OK]

Common Mistakes:

• Assuming tolist() converts maps to lists
• Expecting keys or values as list output
• Ignoring type mismatch errors

4. You wrote this Terraform code but get an error:

variable "ids" {
  default = toset(["1", "2", "3"])
}

output "numbers" {
  value = tonumber(var.ids)
}

What is the problem?

medium

A. Output block syntax is incorrect

B. toset() cannot convert lists to sets

C. Variable "ids" must be a string, not a set

D. tonumber() cannot convert a set directly; it needs a single string or number

Solution

1. Step 1: Analyze the variable type

   Variable "ids" is a set of strings, created by toset(["1", "2", "3"]).

2. Step 2: Check usage of tonumber()

   The function tonumber() expects a single string or number, not a set. Passing a set causes an error.

3. Final Answer:

   tonumber() cannot convert a set directly; it needs a single string or number -> Option D

4. Quick Check:

   tonumber(set) = error [OK]

Hint: tonumber() works on single values, not collections [OK]

Common Mistakes:

• Trying to convert whole sets with tonumber()
• Confusing toset() behavior
• Assuming output block syntax is wrong

5. You have a list of numbers as strings: ["10", "20", "30"]. You want to convert it to a set of numbers in Terraform. Which expression correctly does this?

hard

A. tolist(toset(["10", "20", "30"]))

B. toset(tolist(tonumber(["10", "20", "30"])))

C. toset([for v in ["10", "20", "30"] : tonumber(v)])

D. tonumber(toset(["10", "20", "30"]))

Solution

1. Step 1: Understand the input and desired output

   The input is a list of strings representing numbers. The goal is to get a set of numbers.

2. Step 2: Use a for-expression to convert each string to number

   Using [for v in list : tonumber(v)] converts each string to a number, producing a list of numbers.

3. Step 3: Convert the resulting list to a set

   Wrapping the for-expression with toset() converts the list of numbers to a set.

4. Final Answer:

   toset([for v in ["10", "20", "30"] : tonumber(v)]) -> Option C

5. Quick Check:

   Convert strings to numbers then to set [OK]

Hint: Use for-expression with tonumber() inside toset() [OK]

Common Mistakes:

• Trying to apply tonumber() directly to a list
• Converting to list after tonumber() without iteration
• Using tonumber() on a set directly