Overview

Package ioutil implements some I/O utility functions.

Index

• func NopCloser(r io.Reader) io.ReadCloser
• func ReadDir(dirname string) ([]os.FileInfo, error)
• func TempDir(dir, prefix string) (name string, err error)
• func WriteFile(filename string, data []byte, perm os.FileMode) error

• ReadDir
• TempDir

Package files

tempfile.go

Discard is an io.Writer on which all Write calls succeed without doing anything.

func
¶

func NopCloser(r .Reader) .ReadCloser

NopCloser returns a ReadCloser with a no-op Close method wrapping the provided
Reader r.

func
¶

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

Example:

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)
// Output:
// Go is a general-purpose language designed with systems programming in mind.

ReadDir reads the directory named by dirname and returns a list of directory
entries sorted by filename.

Example:

files, err := ioutil.ReadDir(".")
if err != nil {
    log.Fatal(err)
}
for _, file := range files {
}

func
¶

func ReadFile(filename ) ([]byte, )

ReadFile reads the file named by filename and returns the contents. A successful
call returns err == nil, not err == EOF. Because ReadFile reads the whole file,
it does not treat an EOF from Read as an error to be reported.

Example:

content, err := ioutil.ReadFile("testdata/hello")
if err != nil {
    log.Fatal(err)
}
fmt.Printf("File contents: %s", content)
// Output:
// File contents: Hello, Gophers!

func
¶

TempDir creates a new temporary directory in the directory dir with a name
beginning with prefix and returns the path of the new directory. If dir is the
empty string, TempDir uses the default directory for temporary files (see
os.TempDir). Multiple programs calling TempDir simultaneously will not choose
the same directory. It is the caller’s responsibility to remove the directory
when no longer needed.

Example:

content := []byte("temporary file's content")
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 *.File, err )

TempFile creates a new temporary file in the directory dir with a name beginning
with prefix, opens the file for reading and writing, and returns the resulting
*os.File. If dir is the empty string, TempFile uses the default directory for
temporary files (see os.TempDir). Multiple programs calling TempFile
simultaneously will not choose the same file. The caller can use f.Name() to
find the pathname of the file. It is the caller’s responsibility to remove the
file when no longer needed.

Example:

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
¶