Go标准库 - io io/ioutil

雪冷冷 · · 2286 次点击 · · 开始浏览

这是一个创建于的文章，其中的信息可能已经有所发展或是发生改变。

接口定义-基本接口

//-----------------------------------------------------------------------------
//===================================基本接口===================================
//-----------------------------------------------------------------------------
// Reader 接口用来输出自己的字节数据。只有一个鸭子方法Read。
// 参数p：将对象的数据流读入到 p 中，p是调用方准备用来盛放数据的[]byte。
// 返回值：
// 1 如果已读到了数据（n > 0） 则 err = nil
// 2 如果没有数据可读（n = 0） 则 err = io.EOF
// 3 如果发生读取错误（n = _） 则 err = other errors
type Reader interface {
    Read(p []byte) (n int, err error)
}

// Writer 接口用于将数据写入自身。只有一个鸭子方法Write。
// 参数p：将p中的数据写入到对象中，p是调用方准备的数据。
// 返回值：
// 1 如果数据全部被写入（n = len(p)），则 err = nil
// 2 如果数据无法被全部写入(n = 写入了的字节数)，则 err = other errors
type Writer interface {
    Write(p []byte) (n int, err error)
}

// Closer 接口用于关闭数据读写句柄。只有一个鸭子方法Close。
type Closer interface {
    Close() error
}

// Seeker 接口用于移动数据的读写指针。只有一个鸭子方法Seek。跟C语言一样。
// 参数whence：
//   如果 whence 为 0：表示从数据的开头开始移动指针。
//   如果 whence 为 1：表示从数据的当前指针位置开始移动指针。
//   如果 whence 为 2：表示从数据的尾部开始移动指针。
// 参数offset：
//   是指针移动的偏移量（理论上是可以正负值的，当然有些流是不支持的。）。
// 返回值：
//   返回新指针位置 和 遇到的错误。
type Seeker interface {
    Seek(offset int64, whence int) (ret int64, err error)
}

//-----------------------------------------------------------------------------
//=================================基本组合接口=================================
//-----------------------------------------------------------------------------

有疑问加站长微信联系（非本文作者）