I/O *** 作也叫输入输出 *** 作。其中 I 是指 Input,O 是指 Output,用于读或者写数据的,有些语言中也叫流 *** 作,是指数据通信的通道。
Golang 标准库对 IO 的抽象非常精巧,各个组件可以随意组合,可以作为接口设计的典范。
io 包中提供 I/O 原始 *** 作的一系列接口。它主要包装了一些已有的实现,如 os 包中的那些,并将这些抽象成为实用性的功能和一些其他相关的接口。
在 io 包中最重要的是两个接口:Reader 和 Writer 接口,首先来介绍这读的 *** 则茄作。
Reader 接口的定义,Read() 方法用于读取数据。
Read 将 len(p) 个字节读取到 p 中。它返回读取的字节数 n(0 <= n <= len(p))以及任何遇到的错误。即使 Read 返回的 n <len(p),它也会在调用过程
中使用 p 的全部作为暂存空间。若一些数据可用但不到 len(p) 个字节,Read 会照例返回可用的东西,而不是等待更多。
当 Read 在成功读取 n >0 个字节后遇到一个错误或 EOF 情况,它就会返回读取的字节数,这种一般情况的一个例子就是 Reader 在输入流结束时会返回一个非零的字节数,可能的返回不是 err == EOF 就是 err == nil。无论如何,下一个 Read 都应当返回 0、EOF。
调用者应当总在考虑到错误 err 前处理 n >0 的字节。这样做可以在读取一些字节,以及允许的 EOF 行为后正确地处理 I/O 错误。
Read 的实现会阻止返回零字节的计数和一个 nil 错误,调用者应将这种情况视作空 *** 作。
ReaderFrom接口的定义,封装了基本的 ReadFrom 方法。
ReadFrom 从 r 中读取数据到对象的数据流中,直到 r 返回 EOF 或 r 出现读取错误为止,返回值 n 是读取的字节数,返回值 err 就是 r 的返回值 err。
定义ReaderAt接口,ReaderAt 接口封装了基本的 ReadAt 方法
ReadAt 从对象数据流的 off 处读出数据到 p 中,忽略数据的读写指针,从数据的起始位置偏移 off 处开始读取,如果对象的数据流只有部分可用,不足以填满 p,则 ReadAt 将等待所有数据可用之后,继续向 p 中写入,直到将 p 填满后再返回。
在这点上 ReadAt 要比 Read 更严格,返回读取的字节数 n 和读取时遇到的错误,如果 n <len(p),则需要返回一个 err 值来说明,为什么没有将 p 填满(比如 EOF),如果 n = len(p),而且对象的数据没有全部读完,则 err 将返回 nil,如果 n = len(p),而且对象的数据刚好全部读完,则 err 将返回 EOF 或者 nil(不确定)
file 类是在 os 包中的,封装了底层的文件描述符和相关信息,同时封装了 Read 和 Write 的实现。
读取文件中的数据:
Writer 接口的定义,Write() 方法用于写出数据。
Write 将 len(p) 个字节从 p 中写入到基本数据流中。它返回漏拍从 p 中被写入的字节数 n(0 <= n <= len(p))以及任何遇到的引起写入提前停止的错误。若 Write 返回的 n <len(p),它就必须返回一个非 nil 的错误。Write 不能修改此切片的数据,即便它是临时的。
Seeker接口的定义,封装了基本的 Seek 方法。
Seeker 用来移动数据的读写指针,Seek 设置下一次读写 *** 作的指针位置,每次的读写 *** 作都是返盯羡从指针位置开始的。
whence 的含义:
如果 whence 为 0:表示从数据的开头开始移动指针
如果 whence 为 1:表示从数据的当前指针位置开始移动指针
如果 whence 为 2:表示从数据的尾部开始移动指针
offset 是指针移动的偏移量
返回移动后的指针位置和移动过程中遇到的任何错误
WriterTo接口的定义,封装了基本的 WriteTo 方法。
WriterTo 将对象的数据流写入到 w 中,直到对象的数据流全部写入完毕或遇到写入错误为止。返回值 n 是写入的字节数,返回值 err 就是 w 的返回值 err。
定义WriterAt接口,WriterAt 接口封装了基本的 WriteAt 方法
WriteAt 将 p 中的数据写入到对象数据流的 off 处,忽略数据的读写指针,从数据的起始位置偏移 off 处开始写入,返回写入的字节数和写入时遇到的错误。如果 n <len(p),则必须返回一个 err 值来说明为什么没有将 p 完全写入
file 类是在 os 包中的,封装了底层的文件描述符和相关信息,同时封装了 Read 和 Write 的实现。
写出数据到本地文件:
使用文件名作为输入
另一个常见错误是将文件名传递给函数。
假设我们必须实现一个函数来计算文件埋则中的空行数。最自然的实现是这样的:
filename 作为输入给出,所以我们打开它然后我们实现我们的逻辑,对吧?
现在,假设我们希望在此函数之上实现 单元测试 ,以使用普通文件,空销携文件,具有不同编码类型的文件等进行测试。很容易变得非常难以管理。
此外,如果我们想要实现相同的逻辑但是对于HTTP主体,例如,我们将不得不为此创建另一个函数。
Go有两个很棒的抽象: io.Reader 和 io.Writer 。相反,通过一个文件名,我们可以简单地传递一个 io.Reader 作为 抽象 的数据源。
它是文件吗?一个HTTP正文?字节缓冲区?这并不重要,因为我们仍然会使用相同的 Read 方法。
在我们的例子中,我们甚至可以缓冲输入以逐行读取它。所以,我们弯斗棚可以使用 bufio.Reader 它的 ReadLine 方法:
现在,打开文件本身的责任委托给 count 客户:
使用第二种实现,无论 实际数据源 如何,都可以调用该函数。同时,它将 促进 我们的单元测试,因为我们可以简单地创建一个 bufio.Reader 来自 string :
翻译自: https://medium.com/swlh/the-most-common-mistakes-with-read-file-in-golang-be87239fd03b
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)