©
本文档使用
php中文网手册 发布
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)}