io/ioutil
Package 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
包文件
变量
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 会在写入之前将其截断。
