目錄 搜尋
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 "net/mail"

  • 概况

  • 索引

  • 例子

概况

Package mail 实现邮件消息的解析。

在大多数情况下,这个包遵循 RFC 5322 规定的语法,并由 RFC 6532 扩展。值得注意的分歧:

* Obsolete address formats are not parsed, including addresses with
  embedded route information.* Group addresses are not parsed.* The full range of spacing (the CFWS syntax element) is not supported,
  such as breaking addresses across lines.* No unicode normalization is performed.

索引

  • 变量

  • func ParseAddressList(list string) ([]*Address, error)

  • func ParseDate(date string) (time.Time, error)

  • type Address

  • func ParseAddress(address string) (*Address, error)

  • func (a *Address) String() string

  • type AddressParser

  • func (p *AddressParser) Parse(address string) (*Address, error)

  • func (p *AddressParser) ParseList(list string) ([]*Address, error)

  • type Header

  • func (h Header) AddressList(key string) ([]*Address, error)

  • func (h Header) Date() (time.Time, error)

  • func (h Header) Get(key string) string

  • type Message

  • func ReadMessage(r io.Reader) (msg *Message, err error)

例子

ParseAddress ParseAddressList ReadMessage

包文件

message.go

变量

var ErrHeaderNotPresent = errors.New("mail: header not in message")

func ParseAddressList

func ParseAddressList(list string) ([]*Address, error)

ParseAddressList 将给定的字符串解析为地址列表。

package mainimport ("fmt""log""net/mail")func main() {const list = "Alice <alice@example.com>, Bob <bob@example.com>, Eve <eve@example.com>"
	emails, err := mail.ParseAddressList(list)if err != nil {
		log.Fatal(err)}for _, v := range emails {
		fmt.Println(v.Name, v.Address)}}

func ParseDate

func ParseDate(date string) (time.Time, error)

ParseDate 分析 RFC 5322 日期字符串。

type Address

Address 代表一个单一的邮件地址。诸如“Barry Gibbs bg@example.com ”的地址表示为地址{名称:“Barry Gibbs”,地址:“bg@example.com”}。

type Address struct {
        Name    string // Proper name; may be empty.
        Address string // user@domain}

func ParseAddress

func ParseAddress(address string) (*Address, error)

Parses a single RFC 5322 address, e.g. "Barry Gibbs bg@example.com"

package mainimport ("fmt""log""net/mail")func main() {
	e, err := mail.ParseAddress("Alice <alice@example.com>")if err != nil {
		log.Fatal(err)}

	fmt.Println(e.Name, e.Address)}

func (*Address) String

func (a *Address) String() string

字符串将地址格式化为有效的 RFC 5322 地址。如果地址名称包含非 ASCII 字符,则该名称将根据 RFC 2047 进行渲染。

type AddressParser

AddressParser 是一个 RFC 5322 地址解析器。

type AddressParser struct {        // WordDecoder optionally specifies a decoder for RFC 2047 encoded-words.
        WordDecoder *mime.WordDecoder}

func (*AddressParser) Parse

func (p *AddressParser) Parse(address string) (*Address, error)

Parse 解析“Gogh Fir gf@example.com ”或“foo@example.com” 形式的单个 RFC 5322 地址。

func (*AddressParser) ParseList

func (p *AddressParser) ParseList(list string) ([]*Address, error)

ParseList 将给定的字符串解析为格式为“Gogh Fir gf@example.com ”或“foo@example.com” 的逗号分隔地址列表。

type Header

Header 表示邮件消息标题中的键值对。

type Header map[string][]string

func (Header) AddressList

func (h Header) AddressList(key string) ([]*Address, error)

AddressList 将指定的标题字段分析为地址列表。

func (Header) Date

func (h Header) Date() (time.Time, error)

Date 分析 Date 标头字段。

func (Header) Get

func (h Header) Get(key string) string

获取与给定键相关的第一个值。它不区分大小写; CanonicalMIMEHeaderKey 用于规范提供的密钥。如果没有与该键关联的值,Get 返回“”。要访问密钥的多个值或使用非规范密钥,请直接访问地图。

type Message

Message 表示解析的邮件消息。

type Message struct {
        Header Header
        Body   io.Reader}

func ReadMessage

func ReadMessage(r io.Reader) (msg *Message, err error)

ReadMessage 从 r 读取消息。标题被解析,并且消息的主体将可用于从 msg.Body 中读取。

package mainimport ("fmt""io/ioutil""log""net/mail""strings")func main() {
	msg := `Date: Mon, 23 Jun 2015 11:40:36 -0400
From: Gopher <from@example.com>
To: Another Gopher <to@example.com>
Subject: Gophers at Gophercon

Message body
`

	r := strings.NewReader(msg)
	m, err := mail.ReadMessage(r)if err != nil {
		log.Fatal(err)}

	header := m.Header
	fmt.Println("Date:", header.Get("Date"))
	fmt.Println("From:", header.Get("From"))
	fmt.Println("To:", header.Get("To"))
	fmt.Println("Subject:", header.Get("Subject"))

	body, err := ioutil.ReadAll(m.Body)if err != nil {
		log.Fatal(err)}
	fmt.Printf("%s", body)}
上一篇: 下一篇: