Files
opentf/website/docs/language/functions/ephemeralasnull.mdx
Christian Mesh 60b268200c Add ephemeralasnull() function (#3154)
Signed-off-by: Christian Mesh <christianmesh1@gmail.com>
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
Signed-off-by: Christian Mesh <christianmesh1@gmail.com>
2025-09-10 07:45:23 -04:00

31 lines
742 B
Plaintext

---
sidebar_label: ephemeralasnull
description: The ephemeral as null function replaces all ephemeral values within the given object with null.
---
# `ephemeralasnull` Function
`ephemeralasnull` takes any value and returns a copy of it with any ephemeral values replaced with null. Ephemeral
values can come from variables and outputs marked as ephemeral, as well as ephemeral resources.
## Examples
```hcl
> ephemeralasnull("Hello World")
"Hello World"
> ephemeralasnull(var.ephemeral_variable)
null
> ephemeralasnull(ephemeral.some_resource)
null
> ephemeralasnull([4, var.ephemeral_variable])
[4, null]
> ephemeralasnull({
"field": "value",
"ephemeral": var.ephemeral_variable,
})
{
"field": "value",
"ephemeral": null,
}
```