?
本文檔使用 php中文網(wǎng)手冊 發(fā)布
import "net/mail"
概況
索引
例子
概況
Package mail 實現(xiàn)郵件消息的解析。
在大多數(shù)情況下，這個包遵循 RFC 5322 規(guī)定的語法，并由 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 字符，則該名稱將根據(jù) RFC 2047 進(jìn)行渲染。
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 表示郵件消息標(biāo)題中的鍵值對。
type Header map[string][]string
func (Header) AddressList
func (h Header) AddressList(key string) ([]*Address, error)
AddressList 將指定的標(biāo)題字段分析為地址列表。
func (Header) Date
func (h Header) Date() (time.Time, error)
Date 分析 Date 標(biāo)頭字段。
func (Header) Get
func (h Header) Get(key string) string
獲取與給定鍵相關(guān)的第一個值。它不區(qū)分大小寫; CanonicalMIMEHeaderKey 用于規(guī)范提供的密鑰。如果沒有與該鍵關(guān)聯(lián)的值，Get 返回“”。要訪問密鑰的多個值或使用非規(guī)范密鑰，請直接訪問地圖。
type Message
Message 表示解析的郵件消息。
type Message struct {
Header Header
Body io.Reader}func ReadMessage
func ReadMessage(r io.Reader) (msg *Message, err error)
ReadMessage 從 r 讀取消息。標(biāo)題被解析，并且消息的主體將可用于從 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)}