# package ioutil `import "io/ioutil"` Package ioutil implements some I/O utility functions. ## Index * [Variables](#pkg-variables) * [func NopCloser(r io.Reader) io.ReadCloser](#NopCloser) * [func ReadAll(r io.Reader) ([]byte, error)](#ReadAll) * [func ReadFile(filename string) ([]byte, error)](#ReadFile) * [func WriteFile(filename string, data []byte, perm os.FileMode) error](#WriteFile) * [func ReadDir(dirname string) ([]os.FileInfo, error)](#ReadDir) * [func TempDir(dir, prefix string) (name string, err error)](#TempDir) * [func TempFile(dir, prefix string) (f \*os.File, err error)](#TempFile) ## Variables ``` var Discard io.Writer = devNull(0) ``` Discard是一個io.Writer接口，對它的所有Write調用都會無實際操作的成功返回。 ## func [NopCloser](https://github.com/golang/go/blob/master/src/io/ioutil/ioutil.go#L122 "View Source") ``` func NopCloser(r io.Reader) io.ReadCloser ``` NopCloser用一個無操作的Close方法包裝r返回一個ReadCloser接口。 ## func [ReadAll](https://github.com/golang/go/blob/master/src/io/ioutil/ioutil.go#L41 "View Source") ``` func ReadAll(r io.Reader) ([]byte, error) ``` ReadAll從r讀取數據直到EOF或遇到error，返回讀取的數據和遇到的錯誤。成功的調用返回的err為nil而非EOF。因為本函數定義為讀取r直到EOF，它不會將讀取返回的EOF視為應報告的錯誤。 ## func [ReadFile](https://github.com/golang/go/blob/master/src/io/ioutil/ioutil.go#L49 "View Source") ``` func ReadFile(filename string) ([]byte, error) ``` ReadFile?從filename指定的文件中讀取數據并返回文件的內容。成功的調用返回的err為nil而非EOF。因為本函數定義為讀取整個文件，它不會將讀取返回的EOF視為應報告的錯誤。 ## func [WriteFile](https://github.com/golang/go/blob/master/src/io/ioutil/ioutil.go#L76 "View Source") ``` func WriteFile(filename string, data []byte, perm os.FileMode) error ``` 函數向filename指定的文件中寫入數據。如果文件不存在將按給出的權限創建文件，否則在寫入數據之前清空文件。 ## func [ReadDir](https://github.com/golang/go/blob/master/src/io/ioutil/ioutil.go#L100 "View Source") ``` func ReadDir(dirname string) ([]os.FileInfo, error) ``` 返回dirname指定的目錄的目錄信息的有序列表。 ## func [TempDir](https://github.com/golang/go/blob/master/src/io/ioutil/tempfile.go#L74 "View Source") ``` func TempDir(dir, prefix string) (name string, err error) ``` 在dir目錄里創建一個新的、使用prfix作為前綴的臨時文件夾，并返回文件夾的路徑。如果dir是空字符串，TempDir使用默認用于臨時文件的目錄（參見os.TempDir函數）。?不同程序同時調用該函數會創建不同的臨時目錄，調用本函數的程序有責任在不需要臨時文件夾時摧毀它。 ## func [TempFile](https://github.com/golang/go/blob/master/src/io/ioutil/tempfile.go#L47 "View Source") ``` func TempFile(dir, prefix string) (f *os.File, err error) ``` 在dir目錄下創建一個新的、使用prefix為前綴的臨時文件，以讀寫模式打開該文件并返回os.File指針。如果dir是空字符串，TempFile使用默認用于臨時文件的目錄（參見os.TempDir函數）。不同程序同時調用該函數會創建不同的臨時文件，調用本函數的程序有責任在不需要臨時文件時摧毀它。