目錄 搜尋
archive archive/tar archive/zip bufio bufio(缓存) builtin builtin(内置包) bytes bytes(包字节) compress compress/bzip2(压缩/bzip2) compress/flate(压缩/flate) compress/gzip(压缩/gzip) compress/lzw(压缩/lzw) compress/zlib(压缩/zlib) container container/heap(容器数据结构heap) container/list(容器数据结构list) container/ring(容器数据结构ring) context context(上下文) crypto crypto(加密) crypto/aes(加密/aes) crypto/cipher(加密/cipher) crypto/des(加密/des) crypto/dsa(加密/dsa) crypto/ecdsa(加密/ecdsa) crypto/elliptic(加密/elliptic) crypto/hmac(加密/hmac) crypto/md5(加密/md5) crypto/rand(加密/rand) crypto/rc4(加密/rc4) crypto/rsa(加密/rsa) crypto/sha1(加密/sha1) crypto/sha256(加密/sha256) crypto/sha512(加密/sha512) crypto/subtle(加密/subtle) crypto/tls(加密/tls) crypto/x509(加密/x509) crypto/x509/pkix(加密/x509/pkix) database database/sql(数据库/sql) database/sql/driver(数据库/sql/driver) debug debug/dwarf(调试/dwarf) debug/elf(调试/elf) debug/gosym(调试/gosym) debug/macho(调试/macho) debug/pe(调试/pe) debug/plan9obj(调试/plan9obj) encoding encoding(编码) encoding/ascii85(编码/ascii85) encoding/asn1(编码/asn1) encoding/base32(编码/base32) encoding/base64(编码/base64) encoding/binary(编码/binary) encoding/csv(编码/csv) encoding/gob(编码/gob) encoding/hex(编码/hex) encoding/json(编码/json) encoding/pem(编码/pem) encoding/xml(编码/xml) errors errors(错误) expvar expvar flag flag(命令行参数解析flag包) fmt fmt go go/ast(抽象语法树) go/build go/constant(常量) go/doc(文档) go/format(格式) go/importer go/parser go/printer go/scanner(扫描仪) go/token(令牌) go/types(类型) hash hash(散列) hash/adler32 hash/crc32 hash/crc64 hash/fnv html html html/template(模板) image image(图像) image/color(颜色) image/color/palette(调色板) image/draw(绘图) image/gif image/jpeg image/png index index/suffixarray io io io/ioutil log log log/syslog(日志系统) math math math/big math/big math/bits math/bits math/cmplx math/cmplx math/rand math/rand mime mime mime/multipart(多部分) mime/quotedprintable net net net/http net/http net/http/cgi net/http/cookiejar net/http/fcgi net/http/httptest net/http/httptrace net/http/httputil net/http/internal net/http/pprof net/mail net/mail net/rpc net/rpc net/rpc/jsonrpc net/smtp net/smtp net/textproto net/textproto net/url net/url os os os/exec os/signal os/user path path path/filepath(文件路径) plugin plugin(插件) reflect reflect(反射) regexp regexp(正则表达式) regexp/syntax runtime runtime(运行时) runtime/debug(调试) runtime/internal/sys runtime/pprof runtime/race(竞争) runtime/trace(执行追踪器) sort sort(排序算法) strconv strconv(转换) strings strings(字符串) sync sync(同步) sync/atomic(原子操作) syscall syscall(系统调用) testing testing(测试) testing/iotest testing/quick text text/scanner(扫描文本) text/tabwriter text/template(定义模板) text/template/parse time time(时间戳) unicode unicode unicode/utf16 unicode/utf8 unsafe unsafe
文字

  • 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

包文件

ioutil.go tempfile.go

变量

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 mainimport ("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 mainimport ("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 mainimport ("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 mainimport ("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 mainimport ("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 upif _, 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 会在写入之前将其截断。

上一篇: 下一篇: