目錄 搜尋
archive archive/tar archive/zip bufio bufio(缓存) builtin builtin(内置包) bytes bytes(包字节) compress compress/bzip2(压缩/bzip2) compress/flate(压缩/flate) compress/gzip(压缩/gzip) compress/lzw(压缩/lzw) compress/zlib(压缩/zlib) container container/heap(容器数据结构heap) container/list(容器数据结构list) container/ring(容器数据结构ring) context context(上下文) crypto crypto(加密) crypto/aes(加密/aes) crypto/cipher(加密/cipher) crypto/des(加密/des) crypto/dsa(加密/dsa) crypto/ecdsa(加密/ecdsa) crypto/elliptic(加密/elliptic) crypto/hmac(加密/hmac) crypto/md5(加密/md5) crypto/rand(加密/rand) crypto/rc4(加密/rc4) crypto/rsa(加密/rsa) crypto/sha1(加密/sha1) crypto/sha256(加密/sha256) crypto/sha512(加密/sha512) crypto/subtle(加密/subtle) crypto/tls(加密/tls) crypto/x509(加密/x509) crypto/x509/pkix(加密/x509/pkix) database database/sql(数据库/sql) database/sql/driver(数据库/sql/driver) debug debug/dwarf(调试/dwarf) debug/elf(调试/elf) debug/gosym(调试/gosym) debug/macho(调试/macho) debug/pe(调试/pe) debug/plan9obj(调试/plan9obj) encoding encoding(编码) encoding/ascii85(编码/ascii85) encoding/asn1(编码/asn1) encoding/base32(编码/base32) encoding/base64(编码/base64) encoding/binary(编码/binary) encoding/csv(编码/csv) encoding/gob(编码/gob) encoding/hex(编码/hex) encoding/json(编码/json) encoding/pem(编码/pem) encoding/xml(编码/xml) errors errors(错误) expvar expvar flag flag(命令行参数解析flag包) fmt fmt go go/ast(抽象语法树) go/build go/constant(常量) go/doc(文档) go/format(格式) go/importer go/parser go/printer go/scanner(扫描仪) go/token(令牌) go/types(类型) hash hash(散列) hash/adler32 hash/crc32 hash/crc64 hash/fnv html html html/template(模板) image image(图像) image/color(颜色) image/color/palette(调色板) image/draw(绘图) image/gif image/jpeg image/png index index/suffixarray io io io/ioutil log log log/syslog(日志系统) math math math/big math/big math/bits math/bits math/cmplx math/cmplx math/rand math/rand mime mime mime/multipart(多部分) mime/quotedprintable net net net/http net/http net/http/cgi net/http/cookiejar net/http/fcgi net/http/httptest net/http/httptrace net/http/httputil net/http/internal net/http/pprof net/mail net/mail net/rpc net/rpc net/rpc/jsonrpc net/smtp net/smtp net/textproto net/textproto net/url net/url os os os/exec os/signal os/user path path path/filepath(文件路径) plugin plugin(插件) reflect reflect(反射) regexp regexp(正则表达式) regexp/syntax runtime runtime(运行时) runtime/debug(调试) runtime/internal/sys runtime/pprof runtime/race(竞争) runtime/trace(执行追踪器) sort sort(排序算法) strconv strconv(转换) strings strings(字符串) sync sync(同步) sync/atomic(原子操作) syscall syscall(系统调用) testing testing(测试) testing/iotest testing/quick text text/scanner(扫描文本) text/tabwriter text/template(定义模板) text/template/parse time time(时间戳) unicode unicode unicode/utf16 unicode/utf8 unsafe unsafe
文字

  • 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

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, 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的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)}

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

上一篇: 下一篇: