ioutil

Documentation

Overview

Package ioutil implements some I/O utility functions.

Index

• Variables
• func NopCloser(r io.Reader) io.ReadCloser
• func ReadAll(r io.Reader) ([]byte, os.Error)
• func ReadDir(dirname string) ([]*os.FileInfo, os.Error)
• func ReadFile(filename string) ([]byte, os.Error)
• func TempDir(dir, prefix string) (name string, err os.Error)
• func TempFile(dir, prefix string) (f *os.File, err os.Error)
• func WriteFile(filename string, data []byte, perm uint32) os.Error

Variables

var Discard io.Writer = devNull(0)

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

Functions

func NopCloser

func NopCloser(r io.Reader) io.ReadCloser

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

func ReadAll

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

ReadAll reads from r until an error or EOF and returns the data it read.

func ReadDir

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

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

func ReadFile

func ReadFile(filename string) ([]byte, os.Error)

ReadFile reads the file named by filename and returns the contents.

func TempDir

func TempDir(dir, prefix string) (name string, err os.Error)

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.

func TempFile

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

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 name of the file. It is the caller's responsibility to remove the file when no longer needed.

func WriteFile

func WriteFile(filename string, data []byte, perm uint32) os.Error

WriteFile writes data to a file named by filename. If the file does not exist, WriteFile creates it with permissions perm; otherwise WriteFile truncates it before writing.