©
本文档使用
php.cn手册 发布
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
func NopCloser(r io.Reader) io.ReadCloser
NopCloser 返回一个 ReadCloser，其中包含提供的 Reader r 的无操作 Close 方法。
func ReadAll
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
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
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
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
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
func WriteFile(filename string, data []byte, perm os.FileMode) error
WriteFile 将数据写入由文件名命名的文件。如果文件不存在，WriteFile 使用 perm 权限创建它；否则 WriteFile 会在写入之前将其截断。