# base64 编解码库

## 功能

base64(text) 创建轻量编解码对象，支持标准 Base64、无补位 Base64、URL 安全 Base64 和 URL 安全无补位 Base64。

## API 列表

| API | 说明 |
| ------ | ------ |
| [base64.encode](/zh-hans/docs/base64/encode) | 把 base64(text) 中保存的文本编码为 Base64 字符串。 |
| [base64.decode](/zh-hans/docs/base64/decode) | 把 base64(text) 中保存的 Base64 字符串解码为 UTF-8 文本。 |
| [base64.to_string](/zh-hans/docs/base64/to_string) | 返回 base64 对象中保存的原始文本。 |

## 示例

```bt
encoded = base64('BT').encode()
raw = base64(encoded).decode()

// 输出：BT
echo(raw)
```

## mode 参数

| mode | 常量 | 说明 |
| ------ | ------ | ------ |
| `0` | `BASE64_STANDARD` | 标准 Base64，带补位符。 |
| `1` | `BASE64_STANDARD_NO_PAD` | 标准 Base64，不输出补位符。 |
| `2` | `BASE64_URL_SAFE` | URL 安全 Base64，带补位符。 |
| `3` | `BASE64_URL_SAFE_NO_PAD` | URL 安全 Base64，不输出补位符。 |

## 注意事项

- Base64 是编码，不是加密；不能用于保存密码、密钥或敏感数据。