©
This document uses PHP Chinese website manual Release
import "io/ioutil"
概况
索引
示例
Package ioutil 实现了一些 I/O 实用程序功能。
变量
func NopCloser(r io.Reader)io.ReadCloser
func ReadAll(r io.Reader) ([]byte, error)
func ReadDir(dirname string) ([]os.FileInfo, error)
func ReadFile(filename string) ([]byte, error)
func TempDir(dir, prefix string) (name string, err error)
func TempFile(dir, prefix string) (f *os.File, err error)
func WriteFile(filename string, data []byte, perm os.FileMode) error
ReadAll ReadDir ReadFile TempDir TempFile
ioutil.go tempfile.go
Discard 是一个 io.Writer,所有 Write 调用都无需执行任何操作即可成功。
var Discard io.Writer = devNull(0)
func NopCloser(r io.Reader) io.ReadCloser
NopCloser 返回一个 ReadCloser,其中包含提供的 Reader r 的无操作 Close 方法。
func ReadAll(r io.Reader) ([]byte, error)
ReadAll 从 r 读取,直到出错或 EOF 并返回它读取的数据。一个成功的调用返回 err == nil,而不是 err == EOF 。由于 ReadAll 被定义为从 src 读取直到 EOF,因此它不会将来自 Read 的 EOF 视为要报告的错误。
package mainimport ("fmt""io/ioutil""log""strings")func main() { r := strings.NewReader("Go is a general-purpose language designed with systems programming in mind.") b, err := ioutil.ReadAll(r)if err != nil { log.Fatal(err)} fmt.Printf("%s", b)}
func ReadDir(dirname string) ([]os.FileInfo, error)
ReadDir 读取由 dirname 命名的目录并返回按文件名排序的目录条目列表。
package mainimport ("fmt""io/ioutil""log")func main() { files, err := ioutil.ReadDir(".")if err != nil { log.Fatal(err)}for _, file := range files { fmt.Println(file.Name())}}
func ReadFile(filename string) ([]byte, error)
ReadFile 读取由文件名命名的文件并返回内容。一个成功的调用返回 err == nil,而不是 err == EOF 。由于ReadFile 读取整个文件,因此它不会将来自 Read 的 EOF 视为要报告的错误。
package mainimport ("fmt""io/ioutil""log")func main() { content, err := ioutil.ReadFile("testdata/hello")if err != nil { log.Fatal(err)} fmt.Printf("File contents: %s", content)}
func TempDir(dir, prefix string) (name string, err error)
TempDir 在目录 dir 中创建一个名称以前缀开头的新临时目录并返回新目录的路径。如果 dir 是空字符串,TempDir 使用临时文件的默认目录(请参阅 os.TempDir)。同时调用 TempDir 的多个程序不会选择相同的目录。当不再需要时删除目录是调用者的责任。
package mainimport ("io/ioutil""log""os""path/filepath")func main() { content := []byte("temporary file's content") dir, err := ioutil.TempDir("", "example")if err != nil { log.Fatal(err)} defer os.RemoveAll(dir) // clean up tmpfn := filepath.Join(dir, "tmpfile")if err := ioutil.WriteFile(tmpfn, content, 0666); err != nil { log.Fatal(err)}}
func TempFile(dir, prefix string) (f *os.File, err error)
TempFile 在目录 dir 中创建一个名称以前缀开头的新临时文件,打开文件进行读写操作,并返回结果* os.File 。如果 dir 是空字符串,TempFile 使用临时文件的默认目录(请参阅 os.TempDir)。同时调用 TempFile 的多个程序不会选择相同的文件。调用者可以使用 f.Name() 来查找文件的路径名。主叫方有责任在不再需要时删除文件。
package mainimport ("io/ioutil""log""os")func main() { content := []byte("temporary file's content") tmpfile, err := ioutil.TempFile("", "example")if err != nil { log.Fatal(err)} defer os.Remove(tmpfile.Name()) // clean upif _, err := tmpfile.Write(content); err != nil { log.Fatal(err)}if err := tmpfile.Close(); err != nil { log.Fatal(err)}}
func WriteFile(filename string, data []byte, perm os.FileMode) error
WriteFile 将数据写入由文件名命名的文件。如果文件不存在,WriteFile 使用 perm 权限创建它;否则 WriteFile 会在写入之前将其截断。