©
This document uses PHP Chinese website manual Release
import "mime"
概述
索引
示例
子目录
mime实现了MIME规范的一部分。
常量
变量
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返回，如果找到媒体类型值但解析可选参数时出错
var ErrInvalidMediaParameter = errors.New("mime: invalid media parameter")func AddExtensionType(ext, typ string) error
AddExtensionType将与扩展ext关联的MIME类型设置为typ。扩展名应以“.html”中的前导点开头。
func ExtensionsByType(typ string) ([]string, error)
ExtensionsByType返回已知与MIME类型typ关联的扩展。返回的扩展名将以“.html”中的前导点开头。当typ没有关联的扩展时，ExtensionsByType返回一个零分片。
func FormatMediaType(t string, param map[string]string) string
FormatMediaType将媒体类型t和参数param序列化为符合RFC 2045和RFC 2616的媒体类型。类型和参数名称以小写形式写入。当任何参数导致标准违规时，FormatMediaType返回空字符串。
func ParseMediaType(v string) (mediatype string, params map[string]string, err error)
ParseMediaType根据RFC 1521分析媒体类型值和任何可选参数。媒体类型是Content-Type和Content-Disposition标头（RFC 2183）中的值。成功时，ParseMediaType返回转换为小写字母的媒体类型，并修剪空白区域和非零映射。如果解析可选参数时出现错误，则媒体类型将与错误ErrInvalidMediaParameter一起返回。返回的映射params从小写属性映射到属性值，其大小保持不变。
func TypeByExtension(ext string) string
TypeByExtension返回与文件扩展名ext关联的MIME类型。扩展分机应该以“.html”中的前导点开头。当ext没有关联类型时，TypeByExtension返回“”。
扩展名首先以区分大小写的方式查找，然后区分大小写。
内置表很小，但在unix上，它是由本地系统的mime.types文件（如果可用的话）以下一个或多个名称扩充的：
/etc/mime.types/etc/apache2/mime.types/etc/apache/mime.types
在Windows上，MIME类型从注册表中提取。
文本类型的字符集参数默认设置为“utf-8”。
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 (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 (d *WordDecoder) DecodeHeader(header string) (string, error)
DecodeHeader解码给定字符串的所有编码字。当且仅当d的CharsetReader返回错误时才返回错误。
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)}WordEncoder是一个RFC 2047编码字编码器。
type WordEncoder byte
func (e WordEncoder) Encode(charset, s string) string
编码返回s的编码字形式。如果s是没有特殊字符的ASCII码，它将不会被返回。提供的字符集是s的IANA字符集名称。它不区分大小写。
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 | 多部分实现了MIME多部分解析，如RFC 2046中所定义； |
quotedprintable | Package quotedprintable实现RFC 2045指定的引用打印编码。 |