...

Package ioutil

import "io/ioutil"
概览
索引

概览 ▾

ioutil 实现了一些I/O的工具函数。

变量

var Discard io.Writer = devNull(0)

Discard 是一个 io.Writer,对它进行的任何 Write 调用都将无条件成功。

func NopCloser

func NopCloser(r io.Reader) io.ReadCloser

NopCloser 将提供的 Reader r 用空操作 Close 方法包装后作为 ReadCloser 返回。

func ReadAll

func ReadAll(r io.Reader) ([]byte, error)

ReadAll 从 r 中读取,直至遇到错误或EOF,然后返回它所读取的数据。 一次成功的调用应当返回 err == nil,而非 err == 因为 ReadAll 被定义为从 src 进行读取直至遇到EOF,它并不会将来自 Read 的EOF视作错误来报告。

func ReadDir

func ReadDir(dirname string) ([]os.FileInfo, error)

ReadDir 读取名为 dirname 的目录并返回一个已排序的目录项列表。

func ReadFile

func ReadFile(filename string) ([]byte, error)

ReadFile 读取名为 filename 的文件并返回其内容。 一次成功的调用应当返回 err == nil,而非 err == EOF。因为 ReadFile 会读取整个文件, 它并不会将来自 Read 的EOF视作错误来报告。

func TempDir

func TempDir(dir, prefix string) (name string, err error)

TempDir 在目录 dir 中创建一个名字以 prefix 开头的新的临时目录并返回该新目录的路径。 若 dir 为空字符串,TempDir 就会为临时文件(Unix将目录也视作文件)使用默认的目录(见 os.TempDir)。多程序同时调用 TempDir 将不会选择相同的目录。当该目录不再被需要时, 调用者应负责将其移除。

func TempFile

func TempFile(dir, prefix string) (f *os.File, err error)

TempFile 在目录 dir 中创建一个名字以 prefix 开头的新的临时文件,打开该文件以用于读写, 并返回其结果 *os.File。若 dir 为空字符串,TempFile 就会为临时文件使用默认的目录(见 os.TempDir)。多程序同时调用 TempFile 将不会选择相同的文件。调用者可使用 f.Name() 来查找该文件的路径名 pathname。当该文件不再被需要时,调用者应负责将其移除。

func WriteFile

func WriteFile(filename string, data []byte, perm os.FileMode) error

WriteFile 将数据写入到名为 filename 的文件中。 若该文件不存在,WriteFile 就会按照权限 perm 创建它;否则 WriteFile 就会在写入前将其截断。