?
本文檔使用 php中文網(wǎng)手冊(cè) 發(fā)布
import "mime"
概述
索引
示例
子目錄
概述
mime實(shí)現(xiàn)了MIME規(guī)范的一部分。
索引
常量
變量
func AddExtensionType(ext, typ string) error
func ExtensionsByType(typ string) ([]string, error)
func FormatMediaType(t string, param map[string]string) string
func ParseMediaType(v string) (mediatype string, params map[string]string, err error)
func TypeByExtension(ext string) string
type WordDecoder
func (d *WordDecoder) Decode(word string) (string, error)
func (d *WordDecoder) DecodeHeader(header string) (string, error)
type WordEncoder
func (e WordEncoder) Encode(charset, s string) string
示例
WordDecoder.Decode WordDecoder.DecodeHeader WordEncoder.Encode
文件包
encodedword.go grammar.go mediatype.go type.go type_unix.go
常量
const ( // BEncoding represents Base64 encoding scheme as defined by RFC 2045.
BEncoding = WordEncoder('b') // QEncoding represents the Q-encoding scheme as defined by RFC 2047.
QEncoding = WordEncoder('q'))變量
ErrInvalidMediaParameter由ParseMediaType返回，如果找到媒體類型值但解析可選參數(shù)時(shí)出錯(cuò)
var ErrInvalidMediaParameter = errors.New("mime: invalid media parameter")func AddExtensionType
func AddExtensionType(ext, typ string) error
AddExtensionType將與擴(kuò)展ext關(guān)聯(lián)的MIME類型設(shè)置為typ。擴(kuò)展名應(yīng)以“.html”中的前導(dǎo)點(diǎn)開(kāi)頭。
func ExtensionsByType
func ExtensionsByType(typ string) ([]string, error)
ExtensionsByType返回已知與MIME類型typ關(guān)聯(lián)的擴(kuò)展。返回的擴(kuò)展名將以“.html”中的前導(dǎo)點(diǎn)開(kāi)頭。當(dāng)typ沒(méi)有關(guān)聯(lián)的擴(kuò)展時(shí)，ExtensionsByType返回一個(gè)零分片。
func FormatMediaType
func FormatMediaType(t string, param map[string]string) string
FormatMediaType將媒體類型t和參數(shù)param序列化為符合RFC 2045和RFC 2616的媒體類型。類型和參數(shù)名稱以小寫(xiě)形式寫(xiě)入。當(dāng)任何參數(shù)導(dǎo)致標(biāo)準(zhǔn)違規(guī)時(shí)，F(xiàn)ormatMediaType返回空字符串。
func ParseMediaType
func ParseMediaType(v string) (mediatype string, params map[string]string, err error)
ParseMediaType根據(jù)RFC 1521分析媒體類型值和任何可選參數(shù)。媒體類型是Content-Type和Content-Disposition標(biāo)頭（RFC 2183）中的值。成功時(shí)，ParseMediaType返回轉(zhuǎn)換為小寫(xiě)字母的媒體類型，并修剪空白區(qū)域和非零映射。如果解析可選參數(shù)時(shí)出現(xiàn)錯(cuò)誤，則媒體類型將與錯(cuò)誤ErrInvalidMediaParameter一起返回。返回的映射params從小寫(xiě)屬性映射到屬性值，其大小保持不變。
func TypeByExtension
func TypeByExtension(ext string) string
TypeByExtension返回與文件擴(kuò)展名ext關(guān)聯(lián)的MIME類型。擴(kuò)展分機(jī)應(yīng)該以“.html”中的前導(dǎo)點(diǎn)開(kāi)頭。當(dāng)ext沒(méi)有關(guān)聯(lián)類型時(shí)，TypeByExtension返回“”。
擴(kuò)展名首先以區(qū)分大小寫(xiě)的方式查找，然后區(qū)分大小寫(xiě)。
內(nèi)置表很小，但在unix上，它是由本地系統(tǒng)的mime.types文件（如果可用的話）以下一個(gè)或多個(gè)名稱擴(kuò)充的：
/etc/mime.types/etc/apache2/mime.types/etc/apache/mime.types
在Windows上，MIME類型從注冊(cè)表中提取。
文本類型的字符集參數(shù)默認(rèn)設(shè)置為“utf-8”。
type WordDecoder
WordDecoder解碼包含RFC 2047編碼字的MIME頭。
type WordDecoder struct { // CharsetReader, if non-nil, defines a function to generate // charset-conversion readers, converting from the provided // charset into UTF-8. // Charsets are always lower-case. utf-8, iso-8859-1 and us-ascii charsets // are handled by default. // One of the CharsetReader's result values must be non-nil.
CharsetReader func(charset string, input io.Reader) (io.Reader, error)}func (*WordDecoder) Decode
func (d *WordDecoder) Decode(word string) (string, error)
解碼RFC 2047編碼字。
示例
package mainimport ("bytes""fmt""io""io/ioutil""mime")func main() {
dec := new(mime.WordDecoder)
header, err := dec.Decode("=?utf-8?q?=C2=A1Hola,_se=C3=B1or!?=")if err != nil {panic(err)}
fmt.Println(header)
dec.CharsetReader = func(charset string, input io.Reader) (io.Reader, error) {switch charset {case "x-case":// Fake character set for example.// Real use would integrate with packages such// as code.google.com/p/go-charset
content, err := ioutil.ReadAll(input)if err != nil {return nil, err}return bytes.NewReader(bytes.ToUpper(content)), nildefault:return nil, fmt.Errorf("unhandled charset %q", charset)}}
header, err = dec.Decode("=?x-case?q?hello!?=")if err != nil {panic(err)}
fmt.Println(header)}func (*WordDecoder) DecodeHeader
func (d *WordDecoder) DecodeHeader(header string) (string, error)
DecodeHeader解碼給定字符串的所有編碼字。當(dāng)且僅當(dāng)d的CharsetReader返回錯(cuò)誤時(shí)才返回錯(cuò)誤。
例
package mainimport ("bytes""fmt""io""io/ioutil""mime")func main() {
dec := new(mime.WordDecoder)
header, err := dec.DecodeHeader("=?utf-8?q?=C3=89ric?= <eric@example.org>, =?utf-8?q?Ana=C3=AFs?= <anais@example.org>")if err != nil {panic(err)}
fmt.Println(header)
header, err = dec.DecodeHeader("=?utf-8?q?=C2=A1Hola,?= =?utf-8?q?_se=C3=B1or!?=")if err != nil {panic(err)}
fmt.Println(header)
dec.CharsetReader = func(charset string, input io.Reader) (io.Reader, error) {switch charset {case "x-case":// Fake character set for example.// Real use would integrate with packages such// as code.google.com/p/go-charset
content, err := ioutil.ReadAll(input)if err != nil {return nil, err}return bytes.NewReader(bytes.ToUpper(content)), nildefault:return nil, fmt.Errorf("unhandled charset %q", charset)}}
header, err = dec.DecodeHeader("=?x-case?q?hello_?= =?x-case?q?world!?=")if err != nil {panic(err)}
fmt.Println(header)}type WordEncoder
WordEncoder是一個(gè)RFC 2047編碼字編碼器。
type WordEncoder byte
func (WordEncoder) Encode
func (e WordEncoder) Encode(charset, s string) string
編碼返回s的編碼字形式。如果s是沒(méi)有特殊字符的ASCII碼，它將不會(huì)被返回。提供的字符集是s的IANA字符集名稱。它不區(qū)分大小寫(xiě)。
例
package mainimport ("fmt""mime")func main() {
fmt.Println(mime.QEncoding.Encode("utf-8", "?Hola, se?or!"))
fmt.Println(mime.QEncoding.Encode("utf-8", "Hello!"))
fmt.Println(mime.BEncoding.Encode("UTF-8", "?Hola, se?or!"))
fmt.Println(mime.QEncoding.Encode("ISO-8859-1", "Caf\xE9"))}子目錄
Name | Synopsis |
|---|---|
multipart | 多部分實(shí)現(xiàn)了MIME多部分解析，如RFC 2046中所定義； |
quotedprintable | Package quotedprintable實(shí)現(xiàn)RFC 2045指定的引用打印編碼。 |