Go标准库 - io io/ioutil

接口定义-基本接口

//-----------------------------------------------------------------------------
//===================================基本接口===================================
//-----------------------------------------------------------------------------
// 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)
}
//-----------------------------------------------------------------------------
//=================================基本组合接口=================================
//-----------------------------------------------------------------------------

本文来自:开源中国博客

感谢作者:雪冷冷

查看原文:Go标准库 - io io/ioutil

• 编辑
• 预览