convert 함수

convert 함수

convert는 값이나 표현식을 주어진 타입으로 변환해 주는 함수예요. 출력 결과의 타입을 명시적으로 정규화하고 싶을 때 사용합니다.

출처: Packer 공식 문서

본문

convert는 값이나 표현식을 주어진 타입으로 변환합니다.

HCL은 필요할 때 타입을 자동으로 변환해 주기 때문에, 명시적인 타입 변환이 필요한 경우는 거의 없어요. 명시적 타입 변환 함수는 주로 출력(outputs)으로 반환되는 값의 타입을 정규화할 때만 사용하세요.

숫자(number)로 변환할 수 있는 것은 숫자와 숫자의 10진 표현을 담은 문자열뿐입니다. 그 외의 모든 값은 오류를 발생시켜요.

불리언(boolean)으로 변환할 수 있는 것은 불리언 값과 정확히 "true", "false"인 문자열뿐입니다. 그 외의 모든 값은 오류를 발생시켜요.

문자열(string)로 변환할 수 있는 것은 원시 타입(string, number, bool)뿐입니다. 그 외의 모든 값은 오류를 발생시켜요.

convert(value, type_constraint)

Examples

> convert(3, string)
"3"
> convert("3", number)
3
> convert("false", bool)
false
> convert(false, string)
"false"
> convert(["a", "b", 3], list)
[
  "a",
  "b",
  "3",
]
> convert(["c", "b", "b"], set)
[
  "b",
  "c",
]
> convert({"a" = "foo", "b" = true}, map)
{
  "a" = "foo"
  "b" = "true"
}