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
©
This document uses PHP Chinese website manual Release
characters
import "encoding/csv"
Overview
Index
Examples
概观
包csv读取和写入逗号分隔值(CSV) 文件。CSV文件有很多种，该软件包支持RFC 4180中描述的格式。
一个csv文件包含每个记录一个或多个字段的零个或多个记录。每条记录由换行符分隔。最后的记录可以选择跟随一个换行符。
field1,field2,field3
白色空间被视为一个领域的一部分。
在换行符被无声删除之前，回车返回。
空白行被忽略。只有空白字符的行（不包括结尾换行符）不被视为空白行。
以引号字符开头和结尾的字段称为引用字段。开始和结束引号不是字段的一部分。
来源：
normal string,"quoted-field"
结果在这些领域
{`normal string`, `quoted-field`}在引用字段中，引号字符后跟第二个引号字符被视为单引号。
"the ""word"" is true","a ""quoted-field"""
results in
{`the "word" is true`, `a "quoted-field"`}换行符和逗号可以包含在引用字段中
"Multi-line field","comma is ,"
results in
{`Multi-line
field`, `comma is ,`}指数
Variables
type ParseError
func (e *ParseError) Error() string
type Reader
func NewReader(r io.Reader) *Reader
func (r *Reader) Read() (record []string, err error)
func (r *Reader) ReadAll() (records [][]string, err error)
type Writer
func NewWriter(w io.Writer) *Writer
func (w *Writer) Error() error
func (w *Writer) Flush()
func (w *Writer) Write(record []string) error
func (w *Writer) WriteAll(records [][]string) error
例子
Reader Reader.ReadAll Reader（选项）Writer Writer.WriteAll
包文件
reader.go writer.go
变量
这些是可以在ParseError.Error中返回的错误
var (
ErrTrailingComma = errors.New("extra delimiter at end of line") // no longer used
ErrBareQuote = errors.New("bare \" in non-quoted-field")
ErrQuote = errors.New("extraneous \" in field")
ErrFieldCount = errors.New("wrong number of fields in line"))type ParseError
解析错误返回ParseError。第一行是1.第一列是0。
type ParseError struct {
Line int // Line where the error occurred
Column int // Column (rune index) where the error occurred
Err error // The actual error}func (*ParseError) Error
func (e *ParseError) Error() string
type Reader
Reader从CSV编码的文件中读取记录。
正如NewReader返回的那样，Reader期望符合RFC 4180的输入。可以在第一次调用Read或ReadAll之前更改导出的字段以定制细节。
type Reader struct { // Comma is the field delimiter. // It is set to comma (',') by NewReader.
Comma rune // Comment, if not 0, is the comment character. Lines beginning with the // Comment character without preceding whitespace are ignored. // With leading whitespace the Comment character becomes part of the // field, even if TrimLeadingSpace is true.
Comment rune // FieldsPerRecord is the number of expected fields per record. // If FieldsPerRecord is positive, Read requires each record to // have the given number of fields. If FieldsPerRecord is 0, Read sets it to // the number of fields in the first record, so that future records must // have the same field count. If FieldsPerRecord is negative, no check is // made and records may have a variable number of fields.
FieldsPerRecord int // If LazyQuotes is true, a quote may appear in an unquoted field and a // non-doubled quote may appear in a quoted field.
LazyQuotes bool
TrailingComma bool // ignored; here for backwards compatibility // If TrimLeadingSpace is true, leading white space in a field is ignored. // This is done even if the field delimiter, Comma, is white space.
TrimLeadingSpace bool // ReuseRecord controls whether calls to Read may return a slice sharing // the backing array of the previous call's returned slice for performance. // By default, each call to Read returns newly allocated memory owned by the caller.
ReuseRecord bool // contains filtered or unexported fields}例
package mainimport ("encoding/csv""fmt""io""log""strings")func main() {in := `first_name,last_name,username
"Rob","Pike",rob
Ken,Thompson,ken
"Robert","Griesemer","gri"
`
r := csv.NewReader(strings.NewReader(in))for {
record, err := r.Read()if err == io.EOF {break}if err != nil {
log.Fatal(err)}
fmt.Println(record)}}示例（选项）
此示例显示如何配置csv.Reader以处理其他类型的CSV文件。
package mainimport ("encoding/csv""fmt""log""strings")func main() {in := `first_name;last_name;username
"Rob";"Pike";rob
# lines beginning with a # character are ignored
Ken;Thompson;ken
"Robert";"Griesemer";"gri"
`
r := csv.NewReader(strings.NewReader(in))
r.Comma = ';'
r.Comment = '#'
records, err := r.ReadAll()if err != nil {
log.Fatal(err)}
fmt.Print(records)}func NewReader
func NewReader(r io.Reader) *Reader
NewReader返回一个新的从r读取的Reader。
func (*Reader) Read
func (r *Reader) Read() (record []string, err error)
读取从r读取一个记录（一段字段）。如果记录具有意外数量的字段，则Read将返回记录以及错误ErrFieldCount。除此之外，Read总是返回一个非零记录或一个非零错误，但不是两者都有。如果没有数据需要读取，则读取返回nil，io.EOF。如果ReuseRecord为true，则可以在多次调用Read之间共享返回的切片。
func (*Reader) ReadAll
func (r *Reader) ReadAll() (records [][]string, err error)
ReadAll从r读取所有剩余的记录。每条记录都是一片田地。成功的调用返回err == nil，而不是err == io.EOF。由于ReadAll被定义为读取直到EOF，因此它不会将文件末尾视为要报告的错误。
例
package mainimport ("encoding/csv""fmt""log""strings")func main() {in := `first_name,last_name,username
"Rob","Pike",rob
Ken,Thompson,ken
"Robert","Griesemer","gri"
`
r := csv.NewReader(strings.NewReader(in))
records, err := r.ReadAll()if err != nil {
log.Fatal(err)}
fmt.Print(records)}type Writer
Writer将记录写入CSV编码文件。
如NewWriter返回的，Writer写入由换行符终止的记录，并使用'，'作为字段分隔符。在首次调用Write或WriteAll之前，可以更改导出的字段以定制细节。
逗号是字段分隔符。
如果UseCRLF为true，则Writer以\ r \ n结束每个记录而不是\ n。
type Writer struct {
Comma rune // Field delimiter (set to ',' by NewWriter)
UseCRLF bool // True to use \r\n as the line terminator // contains filtered or unexported fields}例
package mainimport ("encoding/csv""log""os")func main() {
records := [][]string{{"first_name", "last_name", "username"},{"Rob", "Pike", "rob"},{"Ken", "Thompson", "ken"},{"Robert", "Griesemer", "gri"},}
w := csv.NewWriter(os.Stdout)for _, record := range records {if err := w.Write(record); err != nil {
log.Fatalln("error writing record to csv:", err)}}// Write any buffered data to the underlying writer (standard output).
w.Flush()if err := w.Error(); err != nil {
log.Fatal(err)}}func NewWriter
func NewWriter(w io.Writer) *Writer
NewWriter返回一个写入w的新Writer。
func (*Writer) Error
func (w *Writer) Error() error
错误报告在先前写入或刷新期间发生的任何错误。
func (*Writer) Flush
func (w *Writer) Flush()
Flush将任何缓冲的数据写入底层的io.Writer。要检查在刷新过程中是否发生错误，请调用错误。
func (*Writer) Write
func (w *Writer) Write(record []string) error
Writer写一个CSV记录以及任何必要的报价。记录是一串字符串，每个字符串都是一个字段。
func (*Writer) WriteAll
func (w *Writer) WriteAll(records [][]string) error
WriteAll使用Write写入多个CSV记录，然后调用Flush。
例
package mainimport ("encoding/csv""log""os")func main() {
records := [][]string{{"first_name", "last_name", "username"},{"Rob", "Pike", "rob"},{"Ken", "Thompson", "ken"},{"Robert", "Griesemer", "gri"},}
w := csv.NewWriter(os.Stdout)
w.WriteAll(records) // calls Flush internallyif err := w.Error(); err != nil {
log.Fatalln("error writing csv:", err)}}