mirror of
https://github.com/opentffoundation/opentf.git
synced 2025-12-21 10:47:34 -05:00
a15a6c9657
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
32 lines
1.2 KiB
Plaintext
32 lines
1.2 KiB
Plaintext
---
|
|
sidebar_label: base64gzip
|
|
description: |-
|
|
The base64encode function compresses the given string with gzip and then
|
|
encodes the result in Base64.
|
|
---
|
|
|
|
# `base64gzip` Function
|
|
|
|
`base64gzip` compresses a string with gzip and then encodes the result in
|
|
Base64 encoding.
|
|
|
|
OpenTofu uses the "standard" Base64 alphabet as defined in
|
|
[RFC 4648 section 4](https://tools.ietf.org/html/rfc4648#section-4).
|
|
|
|
Strings in the OpenTofu language are sequences of unicode characters rather
|
|
than bytes, so this function will first encode the characters from the string
|
|
as UTF-8, then apply gzip compression, and then finally apply Base64 encoding.
|
|
|
|
While we do not recommend manipulating large, raw binary data in the OpenTofu
|
|
language, this function can be used to compress reasonably sized text strings
|
|
generated within the OpenTofu language. For example, the result of this
|
|
function can be used to create a compressed object in Amazon S3 as part of
|
|
an S3 website.
|
|
|
|
## Related Functions
|
|
|
|
* [`base64encode`](../../language/functions/base64encode.mdx) applies Base64 encoding _without_
|
|
gzip compression.
|
|
* [`filebase64`](../../language/functions/filebase64.mdx) reads a file from the local filesystem
|
|
and returns its raw bytes with Base64 encoding.
|