文字
分享

  • import "encoding/base64"

  • Overview

  • Index

  • Examples

概观

包base64实现了RFC 4648规定的base64编码。

package mainimport ("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))}

Index

  • Constants

  • Variables

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

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

  • type CorruptInputError

  • func (e CorruptInputError) Error() string

  • type Encoding

  • func NewEncoding(encoder string) *Encoding

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

  • func (enc *Encoding) DecodeString(s string) ([]byte, error)

  • func (enc *Encoding) DecodedLen(n int) int

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

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

  • func (enc *Encoding) EncodedLen(n int) int

  • func (enc Encoding) Strict() *Encoding

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

例子

Package Encoding.DecodeString Encoding.EncodeToString NewEncoder

包文件

base64.go

常量

const (
        StdPadding rune = '=' // Standard padding character
        NoPadding  rune = -1  // No padding)

变量

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

var RawStdEncoding = StdEncoding.WithPadding(NoPadding)

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

var RawURLEncoding = URLEncoding.WithPadding(NoPadding)

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

var StdEncoding = NewEncoding(encodeStd)

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

var URLEncoding = NewEncoding(encodeURL)

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流编码器。写入返回的作者的数据将使用enc进行编码,然后写入w。Base64编码以4字节块运行; 写完后,调用者必须关闭返回的编码器以刷新任何部分写入的块。

package mainimport ("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()}

type CorruptInputError

type CorruptInputError int64

func (CorruptInputError) Error

func (e CorruptInputError) Error() string

type Encoding

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

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

func NewEncoding

func NewEncoding(encoder string) *Encoding

NewEncoding返回由给定字母表定义的新填充编码,该编码必须是不包含填充字符或CR / LF('\ r','\ n')的64字节字符串。生成的编码使用默认填充字符('='),可以通过WithPadding更改或禁用该字符。

func (*Encoding) Decode

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

解码使用enc编码解码src。它至多将DecodedLen(len(src))字节写入dst并返回写入的字节数。如果src包含无效的base64数据,它将返回成功写入的字节数和CorruptInputError。换行符(\ r和\ n)被忽略。

func (*Encoding) DecodeString

func (enc *Encoding) DecodeString(s string) ([]byte, error)

DecodeString返回由base64字符串s表示的字节。

package mainimport ("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)}

func (*Encoding) DecodedLen

func (enc *Encoding) DecodedLen(n int) int

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

func (*Encoding) Encode

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

使用编码enc对编码src进行编码,将EncodedLen字节写入dst。

编码将输出填充到4个字节的倍数,因此Encode不适用于大数据流的各个块。改用NewEncoder()。

func (*Encoding) EncodeToString

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

EncodeToString返回src的base64编码。

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

func (*Encoding) EncodedLen

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

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

func (Encoding) Strict

func (enc Encoding) Strict() *Encoding

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

func (Encoding) WithPadding

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

WithPadding创建一个与enc相同的新编码,除了指定的填充字符或NoPadding禁用填充。填充字符不能是'\r'或'\n',不能包含在编码的字母表中,并且必须是等于或低于'\xff'的符文。