# 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中讀取。
- 庫
- package achive
- package tar
- package zip
- package bufio
- package builtin
- package bytes
- package compress
- package bzip2
- package flate
- package gzip
- package lzw
- package zlib
- package container
- package heap
- package list
- package ring
- package crypto
- package aes
- package cipher
- package des
- package dsa
- package ecdsa
- package elliptic
- package hmac
- package md5
- package rand
- package rc4
- package rsa
- package sha1
- package sha256
- package sha512
- package subtle
- package tls
- package x509
- package pkix
- package database
- package sql
- package driver
- package encoding
- package ascii85
- package asn1
- package base32
- package base64
- package binary
- package csv
- package gob
- package hex
- package json
- package pem
- package xml
- package errors
- package expvar
- package flag
- package fmt
- package go
- package doc
- package format
- package parser
- package printer
- package hash
- package adler32
- package crc32
- package crc64
- package fnv
- package html
- package template
- package image
- package color
- package palette
- package draw
- package gif
- package jpeg
- package png
- package index
- package suffixarray
- package io
- package ioutil
- package log
- package syslog
- package math
- package big
- package cmplx
- package rand
- package mime
- package multipart
- package net
- package http
- package cgi
- package cookiejar
- package fcgi
- package httptest
- package httputil
- package pprof
- package mail
- package rpc
- package jsonrpc
- package smtp
- package textproto
- package url
- package os
- package exec
- package signal
- package user
- package path
- package filepath
- package reflect
- package regexp
- package runtime
- package cgo
- package debug
- package pprof
- package race
- package sort
- package strconv
- package strings
- package sync
- package atomic
- package text
- package scanner
- package tabwriter
- package template
- package time
- package unicode
- package utf16
- package utf8
- package unsafe