当前位置:首页 > 文章列表 > Golang > Go教程 > Go语言中io包核心接口示例详解

Go语言中io包核心接口示例详解

来源:脚本之家 2023-02-17 16:00:02 0浏览 收藏

怎么入门Golang编程?需要学习哪些知识点?这是新手们刚接触编程时常见的问题;下面golang学习网就来给大家整理分享一些知识点,希望能够给初学者一些帮助。本篇文章就来介绍《Go语言中io包核心接口示例详解》,涉及到接口、go语言io,有需要的可以收藏一下

Go 语言提倡小接口 + 接口组合的方式,来扩展程序的行为以及增加程序的灵活性。io代码包恰恰就可以作为这样的一个标杆,它可以成为我们运用这种技巧时的一个参考标准。io包中包含了大量接口,本篇文章我们就先来学习四个核心接口以及对应的接口组合。

Reader

io.Reader接口定义了 Read 方法,用于读取数据到字节数组中:

  • 入参:字节数组 p,会将数据读入到 p 中
  • 返回值:本次读取的字节数 n,以及遇到的错误 err
type Reader interface {
	Read(p []byte) (n int, err error)
}

方法功能详解

  1. 方法读取数据写入到字节数组 p 中,由于 p 是有大小的,所以一次至多读取 len(p) 个字节
  2. 方法返回读取的数据字节数 n(0
  3. 即使一次调用读取到的数据小于 len(p),也可能会占用整个字节数组 p 作为暂存空间
  4. 如果数据源的数据量小于 len(p) 个字节,方法只会读取当前可用数据,不会等待更多数据的到来

何时返回error

  1. 在成功读取了 n(n>0)个字节后,如果产生了 error 或者 读到文件末尾 (end-of-file),本次调用必须要返回读取的字节数 n,但对于err 的值,可以选择在本次直接返回 err(err!=nil),或者在下次调用的时候再返回 err (n=0, err!=nil)。常见的一个例子就是,读取到n个字节后到达文件末尾(EOF),此时可以返回 err=EOF 或者 err=nil,下次调用返回 n=0,err=EOF。
  2. 调用者需要注意,每次调用后,如果 n>0,应该先处理数据,再考虑 err 是否为 nil。因为上一点已经指出,如果读取到 n>0 个字节后遇到 error,会同时返回 n>0 和 err!=nil,此时就需要先处理数据再考虑 err。

方法实现和调用需注意

  1. 如果想要实现该方法,不推荐同时返回 n=0 和 err=nil,除非 len(p)=0
  2. 如果调用该该方法返回 n=0 和 err=nil,可以认为什么都没有发生,不能认为是读到文件末尾了(end-of-file)
  3. 实现该方法后,一定不要持有字节数组p (保留下地址做他用)

Writer

io.Writer接口定义了 Write 方法,用于写数据到文件中

  • 入参:字节数组 p,会将 p 中的数据写入到文件中
  • 返回值:成功写入完成的字节数 n,以及遇到的错误 err
type Writer interface {
	Write(p []byte) (n int, err error)
}

方法功能详解

  1. 该方法将 p 中的数据写到文件中
  2. 方法返回成功写入的字节数 n(0
  3. 如果 n
  4. 方法一定不能修改字节数组 p,即使是临时修改也不被允许

方法实现需注意

实现该方法后,一定不要持有字节数组p,只是用来读取数据

Closer

io.Closer接口定义了 Close 方法,该方法用于关闭连接。

方法实现需注意

第一次调用该方法后,再次调用该方法应该产生什么行为,该接口没有定义,依赖实现方法自定义。

type Closer interface {
	Close() error
}

Seeker

io.Seeker接口定义了 Seek 方法,该方法用于指定下次读取或者写入时的偏移量

入参:计算新偏移量的起始值 whence, 基于whence的偏移量offset

返回值:基于 whence 和 offset 计算后新的偏移量值,以及可能产生的错误

type Seeker interface {
	Seek(offset int64, whence int) (int64, error)
}

方法功能详解

io包中定义了如下三种 whence

const (
	SeekStart   = 0 // 基于文件开始位置
	SeekCurrent = 1 // 基于当前偏移量 
	SeekEnd     = 2 // 基于文件结束位置
)

如果计算后新的偏移量,在文件起始位置之前,返回 error!=nil

任意正数的偏移量都是合法的,但是对数据源如何进行I/O操作,依赖具体的实现方法

组合接口

在go语言中,可以利用接口的组合,来囊括其他接口中的方法,类似于定义了一个父接口,可以包含多个子接口。如果一个 struct 实现了所有子接口的方法,也就相当于实现了父接口。小接口 + 接口组合的方式,很大程度上增加了程序的灵活性,在我们自己业务开发过程中,可以借鉴这种做法。

针对上面四个最小粒度的接口,io包定义了如下几种组合接口:

// ReadWriter 是 Read 和 Write 方法的组合
type ReadWriter interface {
	Reader
	Writer
}

// ReadCloser 是 Read 和 Close 方法的组合
type ReadCloser interface {
	Reader
	Closer
}

// WriteCloser 是 Write 和 Close 方法的组合
type WriteCloser interface {
	Writer
	Closer
}

// ReadWriteCloser 是 Read、Write 和 Close 方法的组合
type ReadWriteCloser interface {
	Reader
	Writer
	Closer
}

// ReadSeeker 是 Read 和 Seek 方法的组合
type ReadSeeker interface {
	Reader
	Seeker
}

// WriteSeeker 是 Write 和 Seek 方法的组合
type WriteSeeker interface {
	Writer
	Seeker
}

// ReadWriteSeeker 是 Read、Write 和 Seek 方法的组合
type ReadWriteSeeker interface {
	Reader
	Writer
	Seeker
}

总结

本篇文章介绍了 io包 中的四大核心接口:

  • Reader : 读取文件中的数据到字节数组中
  • Writer : 将字节数组的数据写入到文件中
  • Closer : 用于关闭连接
  • Seeker : 给定 whence 和 offset,计算得出新的offset,用于在特定位置开始读写

可以看到 Reader 和 Writer 接口中定义的方法中,都有字节数组p,而底层要操作的文件在方法中都没有体现。Read方法是将文件的数据读入字节数组p,Write 是将字节数组p的数据写入文件,这一点不要记混。

文中关于golang的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《Go语言中io包核心接口示例详解》文章吧,也可关注golang学习网公众号了解相关技术文章。

版本声明
本文转载于:脚本之家 如有侵犯,请联系study_golang@163.com删除
goland最新激活办法goland最新激活办法
上一篇
goland最新激活办法
vscode搭建go开发环境案例详解
下一篇
vscode搭建go开发环境案例详解
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    508次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    497次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • Evidently AI:开源机器学习模型监测与测试工具
    Evidently AI
    探索Evidently AI,一款开源的机器学习模型监测和测试工具,助您优化模型性能,确保模型质量和可靠性。
    3次使用
  • GPTsHunter - 探索和分享最佳GPT应用的首选平台
    GPTsHunter-GPT Store
    GPTsHunter是全球首个且最大的GPTs目录,专为GPT Store用户打造。通过GPTsHunter,您可以轻松分享和发现最佳的GPT应用,提升您的AI体验。
    2次使用
  • BibiGPT:AI一键总结音视频内容,提升学习效率
    BibiGPT
    BibiGPT是您的AI学习助理,通过一键总结哔哩哔哩、YouTube等多平台的音视频内容,帮助您快速抓住核心要点。支持iOS快捷指令,提供免费试用,助力您的学习之旅。
    3次使用
  • Krisp:全球领先的AI降噪与会议助手,提升在线会议效率
    Krisp
    Krisp是全球顶尖的AI降噪应用程序和会议助手,提供AI驱动的降噪、转录、会议笔记和录音功能,适用于个人、小团队和企业,无需信用卡即可使用,提升在线会议的生产力和效率。
    2次使用
  • mmtstock:免费商用高质量图片资源
    mmtstock
    探索mmtstock,获取免费的商用高质量图片。无论是个人项目还是商业用途,mmtstock都能为您提供丰富的图片资源,助您轻松找到所需素材。
    3次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码