| --- | |
| sidebar_label: textdecodebase64 | |
| description: >- | |
| The textdecodebase64 function decodes a string that was previously | |
| Base64-encoded, | |
| and then interprets the result as characters in a specified character | |
| encoding. | |
| --- | |
| # `textdecodebase64` Function | |
| `textdecodebase64` function decodes a string that was previously Base64-encoded, | |
| and then interprets the result as characters in a specified character encoding. | |
| ```hcl | |
| textdecodebase64(string, encoding_name) | |
| ``` | |
| OpenTofu uses the "standard" Base64 alphabet as defined in | |
| [RFC 4648 section 4](https://tools.ietf.org/html/rfc4648#section-4). | |
| The `encoding_name` argument must contain one of the encoding names or aliases | |
| recorded in | |
| [the IANA character encoding registry](https://www.iana.org/assignments/character-sets/character-sets.xhtml). | |
| OpenTofu supports only a subset of the registered encodings, and the encoding | |
| support may vary between OpenTofu versions. | |
| OpenTofu accepts the encoding name `UTF-8`, which will produce the same result | |
| as [`base64decode`](../../language/functions/base64decode.mdx). | |
| ## Examples | |
| ``` | |
| > textdecodebase64("SABlAGwAbABvACAAVwBvAHIAbABkAA==", "UTF-16LE") | |
| Hello World | |
| ``` | |
| ## Related Functions | |
| * [`textencodebase64`](../../language/functions/textencodebase64.mdx) performs the opposite operation, | |
| applying target encoding and then Base64 to a string. | |
| * [`base64decode`](../../language/functions/base64decode.mdx) is effectively a shorthand for | |
| `textdecodebase64` where the character encoding is fixed as `UTF-8`. |