coalesce 함수
coalesce 함수
coalesce는 여러 인자를 받아 그중 null이거나 빈 문자열이 아닌 첫 번째 값을 반환하는 함수예요. 모든 인자는 같은 타입이어야 하며, 타입이 맞지 않는 인자는 Terraform이 자동 타입 변환 규칙에 따라 가장 일반적인 타입으로 변환하려고 시도한답니다.
출처: 문서
본문
coalesce는 임의 개수의 인자를 받아 null이거나 빈 문자열이 아닌 첫 번째 인자를 반환해요. 모든 인자는 같은 타입이어야 해요. Terraform은 타입이 맞지 않는 인자를 모든 인자가 변환될 수 있는 가장 일반적인 타입으로 변환하려고 시도하고, 타입이 호환되지 않으면 오류를 반환해요. 결과 타입은 모든 인자의 타입과 같아요.
예시 (Examples)
> coalesce("a", "b")
a
> coalesce("", "b")
b
> coalesce(1,2)
1
문자열 리스트로 coalesce 연산을 수행하려면 ... 심볼을 사용해 리스트를 인자로 펼치면 돼요.
> coalesce(["", "b"]...)
b
Terraform은 모든 인자가 변환될 수 있는 결과 타입을 선택하려고 시도해요. 그래서 인자 타입을 섞으면 Terraform의 자동 타입 변환 규칙 때문에 예상 밖의 결과가 나올 수 있어요.
> coalesce(1, "hello")
"1"
> coalesce(true, "hello")
"true"
> coalesce({}, "hello")
Error: Error in function call
Call to function "coalesce" failed: all arguments must have the same type.
관련 함수 (Related Functions)
coalescelist는 개별 인자가 아니라 리스트 인자로 비슷한 연산을 수행해요.
더 알아보기 (Learn more)
coalescelist함수 — 리스트 인자 버전try함수 — 오류 없는 첫 결과 반환can함수 — 오류 없이 평가되는지 판별