# package mail `import "net/mail"` mail包實現了郵件的解析。 本包大部分都遵守[RFC 5322](http://tools.ietf.org/html/rfc5322)規定的語法，值得注意的區別是： ``` * 舊格式地址和嵌入遠端信息的地址不會被解析 * 組地址不會被解析 * 不支持全部的間隔符（CFWS語法元素），如分屬兩行的地址 ``` ## Index * [Variables](#pkg-variables) * [type Address](#Address) * [func ParseAddress(address string) (\*Address, error)](#ParseAddress) * [func (a \*Address) String() string](#Address.String) * [func ParseAddressList(list string) ([]\*Address, error)](#ParseAddressList) * [type Header](#Header) * [func (h Header) AddressList(key string) ([]\*Address, error)](#Header.AddressList) * [func (h Header) Date() (time.Time, error)](#Header.Date) * [func (h Header) Get(key string) string](#Header.Get) * [type Message](#Message) * [func ReadMessage(r io.Reader) (msg \*Message, err error)](#ReadMessage) ## Variables ``` var ErrHeaderNotPresent = errors.New("mail: header not in message") ``` ## type [Address](https://github.com/golang/go/blob/master/src/net/mail/message.go#L136 "View Source") ``` type Address struct { Name string // 固有名，可以為空 Address string // user@domain } ``` Address類型表示一個郵箱地址。 例如地址"Barry Gibbs <bg@example.com>"表示為Address{Name: "Barry Gibbs", Address: "bg@example.com"} ### func [ParseAddress](https://github.com/golang/go/blob/master/src/net/mail/message.go#L142 "View Source") ``` func ParseAddress(address string) (*Address, error) ``` 解析單個的[RFC 5322](http://tools.ietf.org/html/rfc5322)地址，例如"Barry Gibbs <bg@example.com>"。 ### func (\*Address) [String](https://github.com/golang/go/blob/master/src/net/mail/message.go#L154 "View Source") ``` func (a *Address) String() string ``` 將a代表的地址表示為合法的[RFC 5322](http://tools.ietf.org/html/rfc5322)地址字符串。如果Name字段包含非ASCII字符將根據[RFC 2047](http://tools.ietf.org/html/rfc2047)轉義。 ## func [ParseAddressList](https://github.com/golang/go/blob/master/src/net/mail/message.go#L147 "View Source") ``` func ParseAddressList(list string) ([]*Address, error) ``` 函數將list作為一串郵箱地址并解析返回。 ## type [Header](https://github.com/golang/go/blob/master/src/net/mail/message.go#L105 "View Source") ``` type Header map[string][]string ``` Header代表郵件頭域的多個鍵值對。 ### func (Header) [AddressList](https://github.com/golang/go/blob/master/src/net/mail/message.go#L125 "View Source") ``` func (h Header) AddressList(key string) ([]*Address, error) ``` 將鍵key對應的值（字符串）作為郵箱地址列表解析并返回。 ### func (Header) [Date](https://github.com/golang/go/blob/master/src/net/mail/message.go#L116 "View Source") ``` func (h Header) Date() (time.Time, error) ``` 解析頭域Date項的值并返回。 ### func (Header) [Get](https://github.com/golang/go/blob/master/src/net/mail/message.go#L109 "View Source") ``` func (h Header) Get(key string) string ``` 返回鍵key對應的第一個值，如果沒有對應值，將返回空字符串。 ## type [Message](https://github.com/golang/go/blob/master/src/net/mail/message.go#L44 "View Source") ``` type Message struct { Header Header Body io.Reader } ``` Message代表一個解析后的郵件。 ### func [ReadMessage](https://github.com/golang/go/blob/master/src/net/mail/message.go#L52 "View Source") ``` func ReadMessage(r io.Reader) (msg *Message, err error) ``` 從r讀取一個郵件，會解析郵件頭域，消息主體可以從r/msg.Body中讀取。