# package base64 `import "encoding/base64"` base64實現了[RFC 4648](http://tools.ietf.org/html/rfc4648)規定的base64編碼。 ## Index * [Variables](#pkg-variables) * [type CorruptInputError](#CorruptInputError) * [func (e CorruptInputError) Error() string](#CorruptInputError.Error) * [type Encoding](#Encoding) * [func NewEncoding(encoder string) \*Encoding](#NewEncoding) * [func (enc \*Encoding) DecodedLen(n int) int](#Encoding.DecodedLen) * [func (enc \*Encoding) Decode(dst, src []byte) (n int, err error)](#Encoding.Decode) * [func (enc \*Encoding) DecodeString(s string) ([]byte, error)](#Encoding.DecodeString) * [func (enc \*Encoding) EncodedLen(n int) int](#Encoding.EncodedLen) * [func (enc \*Encoding) Encode(dst, src []byte)](#Encoding.Encode) * [func (enc \*Encoding) EncodeToString(src []byte) string](#Encoding.EncodeToString) * [func NewDecoder(enc \*Encoding, r io.Reader) io.Reader](#NewDecoder) * [func NewEncoder(enc \*Encoding, w io.Writer) io.WriteCloser](#NewEncoder) ### Examples * [Encoding.DecodeString](#example-Encoding-DecodeString) * [Encoding.EncodeToString](#example-Encoding-EncodeToString) * [NewEncoder](#example-NewEncoder) ## Variables ``` var StdEncoding = NewEncoding(encodeStd) ``` RFC 4648定義的標準base64編碼字符集。 ``` var URLEncoding = NewEncoding(encodeURL) ``` RFC 4648定義的另一base64編碼字符集，用于URL和文件名。 ## type [CorruptInputError](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L210 "View Source") ``` type CorruptInputError int64 ``` ### func (CorruptInputError) [Error](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L212 "View Source") ``` func (e CorruptInputError) Error() string ``` ## type [Encoding](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L24 "View Source") ``` type Encoding struct { // 內含隱藏或非導出字段 } ``` 雙向的編碼/解碼協議，根據一個64字符的字符集定義，[RFC 4648](http://tools.ietf.org/html/rfc4648)標準化了兩種字符集。默認字符集用于MIME（[RFC 2045](http://tools.ietf.org/html/rfc2045)）和PEM（[RFC 1421](http://tools.ietf.org/html/rfc1421)）編碼；另一種用于URL和文件名，用'-'和'\_'替換了'+'和'/'。 ### func [NewEncoding](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L34 "View Source") ``` func NewEncoding(encoder string) *Encoding ``` 使用給出的字符集生成一個\*Encoding，字符集必須是64字節的字符串。 ### func (\*Encoding) [DecodedLen](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L393 "View Source") ``` func (enc *Encoding) DecodedLen(n int) int ``` 返回n字節base64編碼的數據解碼后的最大長度。 ### func (\*Encoding) [Decode](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L288 "View Source") ``` func (enc *Encoding) Decode(dst, src []byte) (n int, err error) ``` 將src的數據解碼后存入dst，最多寫DecodedLen(len(src))字節數據到dst，并返回寫入的字節數。?如果src包含非法字符，將返回成功寫入的字符數和CorruptInputError。換行符（\r、\n）會被忽略。 ### func (\*Encoding) [DecodeString](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L295 "View Source") ``` func (enc *Encoding) DecodeString(s string) ([]byte, error) ``` 返回base64編碼的字符串s代表的數據。 Example ``` 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) [EncodedLen](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L204 "View Source") ``` func (enc *Encoding) EncodedLen(n int) int ``` 返回n字節數據進行base64編碼后的最大長度。 ### func (\*Encoding) [Encode](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L71 "View Source") ``` func (enc *Encoding) Encode(dst, src []byte) ``` 將src的數據編碼后存入dst，最多寫EncodedLen(len(src))字節數據到dst，并返回寫入的字節數。 ?函數會把輸出設置為4的倍數，因此不建議對大數據流的獨立數據塊執行此方法，使用NewEncoder()代替。 ### func (\*Encoding) [EncodeToString](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L118 "View Source") ``` func (enc *Encoding) EncodeToString(src []byte) string ``` 返回將src編碼后的字符串。 Example ``` data := []byte("any + old & data") str := base64.StdEncoding.EncodeToString(data) fmt.Println(str) ``` Output: ``` YW55ICsgb2xkICYgZGF0YQ== ``` ## func [NewDecoder](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L387 "View Source") ``` func NewDecoder(enc *Encoding, r io.Reader) io.Reader ``` 創建一個新的base64流解碼器。 ## func [NewEncoder](https://github.com/golang/go/blob/master/src/encoding/base64/base64.go#L198 "View Source") ``` func NewEncoder(enc *Encoding, w io.Writer) io.WriteCloser ``` 創建一個新的base64流編碼器。寫入的數據會在編碼后再寫入w，base32編碼每3字節執行一次編碼操作；寫入完畢后，使用者必須調用Close方法以便將未寫入的數據從緩存中刷新到w中。 Example ``` 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== ```