io/ioutil

• 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 main

import (
	"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 main

import (
	"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 main

import (
	"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 main

import (
	"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 main

import (
	"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 up

	if _, 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 会在写入之前将其截断。