跳至主要内容

textencodebase64 函数

textencodebase64 使用指定的字符编码对给定字符串中的 unicode 字符进行编码,并返回 Base64 编码的结果,因为 OpenTofu 语言字符串始终是 unicode 字符序列。

代码块
textencodebase64(string, encoding_name)

OpenTofu 使用 RFC 4648 第 4 节 中定义的“标准”Base64 字母表。

encoding_name 参数必须包含 IANA 字符编码注册表 中记录的编码名称或别名之一。OpenTofu 仅支持注册编码的子集,编码支持可能因 OpenTofu 版本而异。特别是,OpenTofu 支持 UTF-16LE,它是 Windows API 的本机字符编码,因此有时会被 Windows 原生的软件(如 PowerShell)期望。

OpenTofu 也接受编码名称 UTF-8,它将生成与 base64encode 相同的结果。

示例

代码块
> textencodebase64("Hello World", "UTF-16LE")
SABlAGwAbABvACAAVwBvAHIAbABkAA==
  • textdecodebase64 执行相反的操作,解码 Base64 数据并将其解释为特定字符编码。
  • base64encode 对字符串的 UTF-8 编码应用 Base64 编码。
  • filebase64 从本地文件系统读取文件,并返回其原始字节,并进行 Base64 编码,不创建中间 Unicode 字符串。