package base64

import "encoding/base64"

Package base64 实现 RFC 4648 所规定的 base64 编码。

Example
package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	msg := "Hello, 世界"
	encoded := base64.StdEncoding.EncodeToString([]byte(msg))
	fmt.Println(encoded)
	decoded, err := base64.StdEncoding.DecodeString(encoded)
	if err != nil {
		fmt.Println("decode error:", err)
		return
	}
	fmt.Println(string(decoded))
}

Output:

SGVsbG8sIOS4lueVjA==
Hello, 世界

Index

Examples

Constants

const (
	StdPadding rune = '=' // 标准填充字符
	NoPadding  rune = -1  // 无填充
)

Variables

var RawStdEncoding = StdEncoding.WithPadding(NoPadding)

RawStdEncoding 是 RFC 4648 第 3.2 节中定义的标准原始、无填充 base64 编码。 它与 StdEncoding 相同,但省略了填充字符。

var RawURLEncoding = URLEncoding.WithPadding(NoPadding)

RawURLEncoding 是 RFC 4648 中定义的无填充替代 base64 编码。 它通常用于 URL 和文件名。 它与 URLEncoding 相同,但省略了填充字符。

var StdEncoding = NewEncoding("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/")

StdEncoding 是 RFC 4648 中定义的标准 base64 编码。

var URLEncoding = NewEncoding("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_")

URLEncoding 是 RFC 4648 中定义的替代 base64 编码。 它通常用于 URL 和文件名。

Functions

func NewDecoder

func NewDecoder(enc *Encoding, r io.Reader) io.Reader

NewDecoder 构造一个新的 base64 流解码器。

func NewEncoder

func NewEncoder(enc *Encoding, w io.Writer) io.WriteCloser

NewEncoder 返回一个新的 base64 流编码器。写入返回的 writer 的数据 将使用 enc 编码,然后写入 w。 Base64 编码以 4 字节块为操作单位;写入完成后, 调用者必须 Close 返回的编码器,以刷新任何 部分写入的块。

Example
package main

import (
	"encoding/base64"
	"os"
)

func main() {
	input := []byte("foo\x00bar")
	encoder := base64.NewEncoder(base64.StdEncoding, os.Stdout)
	encoder.Write(input)
	// Must close the encoder when finished to flush any partial blocks.
	// If you comment out the following line, the last partial block "r"
	// won't be encoded.
	encoder.Close()
}

Output:

Zm9vAGJhcg==

Types

type CorruptInputError

type CorruptInputError int64
func (CorruptInputError) Error
func (e CorruptInputError) Error() string

type Encoding

type Encoding struct {
	// contains filtered or unexported fields
}

Encoding 是一种基数 64 的编码/解码方案,由 64 个字符的字母表定义。 最常见的编码是 RFC 4648 中定义、并用于 MIME(RFC 2045)和 PEM (RFC 1421)的 "base64" 编码。RFC 4648 还定义了一种替代编码, 即用 - 和 _ 替换 + 和 / 的标准编码。

func NewEncoding
func NewEncoding(encoder string) *Encoding

NewEncoding 返回一个新的带填充的 Encoding,由给定的字母表定义, 该字母表必须是包含唯一字节值的 64 字节字符串, 且不包含填充字符或 CR / LF('\r'、'\n')。 字母表被视为字节值序列,对多字节 UTF-8 不做任何特殊处理。 生成的 Encoding 使用默认填充字符('='), 可通过 Encoding.WithPadding 更改或禁用。

func (*Encoding) AppendDecode
func (enc *Encoding) AppendDecode(dst, src []byte) ([]byte, error)

AppendDecode 将 base64 解码后的 src 追加到 dst 并返回扩展后的缓冲区。 如果输入格式错误,它返回部分解码的 src 和一个错误。 换行字符(\r 和 \n)会被忽略。

func (*Encoding) AppendEncode
func (enc *Encoding) AppendEncode(dst, src []byte) []byte

AppendEncode 将 base64 编码后的 src 追加到 dst 并返回扩展后的缓冲区。

func (*Encoding) Decode
func (enc *Encoding) Decode(dst, src []byte) (n int, err error)

Decode 使用编码 enc 解码 src。它最多向 dst 写入 Encoding.DecodedLen(len(src)) 个字节,并返回写入的字节数。 调用者必须确保 dst 足够大以容纳所有解码后的数据。 如果 src 包含无效的 base64 数据,它会返回成功写入的 字节数以及 CorruptInputError。 换行字符(\r 和 \n)会被忽略。

Example
package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	str := "SGVsbG8sIHdvcmxkIQ=="
	dst := make([]byte, base64.StdEncoding.DecodedLen(len(str)))
	n, err := base64.StdEncoding.Decode(dst, []byte(str))
	if err != nil {
		fmt.Println("decode error:", err)
		return
	}
	dst = dst[:n]
	fmt.Printf("%q\n", dst)
}

Output:

"Hello, world!"
func (*Encoding) DecodeString
func (enc *Encoding) DecodeString(s string) ([]byte, error)

DecodeString 返回 base64 字符串 s 所表示的字节。 如果输入格式错误,它返回部分解码的数据以及 CorruptInputError。换行字符(\r 和 \n)会被忽略。

Example
package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	str := "c29tZSBkYXRhIHdpdGggACBhbmQg77u/"
	data, err := base64.StdEncoding.DecodeString(str)
	if err != nil {
		fmt.Println("error:", err)
		return
	}
	fmt.Printf("%q\n", data)
}

Output:

"some data with \x00 and \ufeff"
func (*Encoding) DecodedLen
func (enc *Encoding) DecodedLen(n int) int

DecodedLen 返回与 n 字节 base64 编码数据相对应的 已解码数据的最大字节长度。

func (*Encoding) Encode
func (enc *Encoding) Encode(dst, src []byte)

Encode 使用编码 enc 对 src 进行编码, 向 dst 写入 Encoding.EncodedLen(len(src)) 个字节。

该编码将输出填充到 4 字节的倍数, 因此 Encode 不适合用于大型数据流的单个块。 请改用 NewEncoder。

Example
package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	data := []byte("Hello, world!")
	dst := make([]byte, base64.StdEncoding.EncodedLen(len(data)))
	base64.StdEncoding.Encode(dst, data)
	fmt.Println(string(dst))
}

Output:

SGVsbG8sIHdvcmxkIQ==
func (*Encoding) EncodeToString
func (enc *Encoding) EncodeToString(src []byte) string

EncodeToString 返回 src 的 base64 编码。

Example
package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	data := []byte("any + old & data")
	str := base64.StdEncoding.EncodeToString(data)
	fmt.Println(str)
}

Output:

YW55ICsgb2xkICYgZGF0YQ==
func (*Encoding) EncodedLen
func (enc *Encoding) EncodedLen(n int) int

EncodedLen 返回长度为 n 的输入缓冲区 的 base64 编码的字节长度。

func (Encoding) Strict
func (enc Encoding) Strict() *Encoding

Strict 创建一个新的编码,除启用严格解码外与 enc 相同。 在此模式下,解码器要求末尾填充位为零, 如 RFC 4648 第 3.5 节所述。

注意,输入仍然具有可塑性,因为换行字符(CR 和 LF)仍会被忽略。

func (Encoding) WithPadding
func (enc Encoding) WithPadding(padding rune) *Encoding

WithPadding 创建一个新的编码,除使用指定的填充字符外与 enc 相同, 或使用 NoPadding 禁用填充。 填充字符不能是 '\r' 或 '\n', 不能包含在编码的字母表中, 不能为负数,且必须是等于或小于 '\xff' 的 rune。 高于 '\x7f' 的填充字符按其准确的字节值编码, 而不是使用该码点的 UTF-8 表示。