mime

mime 包

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

文件包

encodedword.go grammar.go mediatype.go type.go type_unix.go

常量

const (
       // BEncoding表示RFC 2045定义的Base64编码方案。
        BEncoding = WordEncoder('b')
        // QEncoding表示RFC 2047定义的Q编码方案。
        QEncoding = WordEncoder('q')
)

变量

ErrInvalidMediaParameter 由 ParseMediaType 返回，如果找到媒体类型值但解析可选参数时出错

var ErrInvalidMediaParameter = errors.New("mime: invalid media parameter")

func AddExtensionType（查看源文件）

func AddExtensionType(ext, typ string) error

AddExtensionType 将与扩展 ext 关联的 MIME 类型设置为 typ 。扩展名应以 “.html” 中的前导点开头。

func ExtensionsByType（查看源文件）

func ExtensionsByType(typ string) ([]string, error)

ExtensionsByType 返回已知与 MIME 类型 typ 关联的扩展。返回的扩展名将以 “.html” 中的前导点开头。当 typ 没有关联的扩展时，ExtensionsByType 返回一个零分片。

func FormatMediaType（查看源文件）

func FormatMediaType(t string, param map[string]string) string

FormatMediaType 将媒体类型 t 和参数 param 序列化为符合 RFC 2045 和 RFC 2616 的媒体类型。类型和参数名称以小写形式写入。当任何参数导致标准违规时，FormatMediaType 返回空字符串。

func ParseMediaType（查看源文件）

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（查看源文件）

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”。

type WordDecoder（查看源文件）

WordDecoder 解码包含 RFC 2047 编码字的 MIME 头。

type WordDecoder struct {
        // CharsetReader，如果是非nil，则定义要生成的函数
         // charset-conversion读者，从提供的转换
         // charset转换为UTF-8。
         //字符集总是小写的。 utf-8，iso-8859-1和us-ascii charsets
         //默认处理。
         //其中一个CharsetReader的结果值必须是非零的。
        CharsetReader func(charset string, input io.Reader) (io.Reader, error)
}

func (*WordDecoder) Decode（查看源文件）

func (d *WordDecoder) Decode(word string) (string, error)

解码 RFC 2047 编码字。

示例

package main

import (
	"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":
			//例如假字符集。
			//实际使用将与包等集成
			//作为code.google.com/p/go-charset
			content, err := ioutil.ReadAll(input)
			if err != nil {
				return nil, err
			}
			return bytes.NewReader(bytes.ToUpper(content)), nil
		default:
			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 的 CharsetReader 返回错误时才返回错误。

示例

package main

import (
	"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":
			//例如假字符集。
			//实际使用将与包等集成
			//作为code.google.com/p/go-charset
			content, err := ioutil.ReadAll(input)
			if err != nil {
				return nil, err
			}
			return bytes.NewReader(bytes.ToUpper(content)), nil
		default:
			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 是一个 RFC 2047 编码字编码器。

type WordEncoder byte

func (WordEncoder) Encode（查看源文件）

func (e WordEncoder) Encode(charset, s string) string

编码返回 s 的编码字形式。如果 s 是没有特殊字符的 ASCII 码，它将不会被返回。提供的字符集是 s 的IANA 字符集名称。它不区分大小写。

示例

package main

import (
	"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指定的引用打印编码。