import "encoding/base64"
base64实现了RFC 4648规定的base64编码。
var StdEncoding = NewEncoding(encodeStd)
RFC 4648定义的标准base64编码字符集。
var URLEncoding = NewEncoding(encodeURL)
RFC 4648定义的另一base64编码字符集,用于URL和文件名。
type CorruptInputError int64
func (e CorruptInputError) Error() string
type Encoding struct {
// 内含隐藏或非导出字段
}
双向的编码/解码协议,根据一个64字符的字符集定义,RFC 4648标准化了两种字符集。默认字符集用于MIME(RFC 2045)和PEM(RFC 1421)编码;另一种用于URL和文件名,用'-'和'_'替换了'+'和'/'。
func NewEncoding(encoder string) *Encoding
使用给出的字符集生成一个*Encoding,字符集必须是64字节的字符串。
func (enc *Encoding) DecodedLen(n int) int
返回n字节base64编码的数据解码后的最大长度。
func (enc *Encoding) Decode(dst, src []byte) (n int, err error)
将src的数据解码后存入dst,最多写DecodedLen(len(src))字节数据到dst,并返回写入的字节数。 如果src包含非法字符,将返回成功写入的字符数和CorruptInputError。换行符(\r、\n)会被忽略。
func (enc *Encoding) DecodeString(s string) ([]byte, error)
返回base64编码的字符串s代表的数据。
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 (enc *Encoding) EncodedLen(n int) int
返回n字节数据进行base64编码后的最大长度。
func (enc *Encoding) Encode(dst, src []byte)
将src的数据编码后存入dst,最多写EncodedLen(len(src))字节数据到dst,并返回写入的字节数。
函数会把输出设置为4的倍数,因此不建议对大数据流的独立数据块执行此方法,使用NewEncoder()代替。
func (enc *Encoding) EncodeToString(src []byte) string
返回将src编码后的字符串。
data := []byte("any + old & data") str := base64.StdEncoding.EncodeToString(data) fmt.Println(str)
Output:
YW55ICsgb2xkICYgZGF0YQ==
func NewDecoder(enc *Encoding, r io.Reader) io.Reader
创建一个新的base64流解码器。
func NewEncoder(enc *Encoding, w io.Writer) io.WriteCloser
创建一个新的base64流编码器。写入的数据会在编码后再写入w,base32编码每3字节执行一次编码操作;写入完毕后,使用者必须调用Close方法以便将未写入的数据从缓存中刷新到w中。
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==