专栏首页Golang开发Golang包——io

Golang包——io

Reader接口

type Reader interface {
    Read(p []byte) (n int, err error)
}

Reader 接口包装了基本的 Read 方法,用于输出自身的数据。Read 方法用于将对象的数据流读入到 p 中,返回读取的字节数和遇到的错误。 如果读到了数据(n > 0),则 err 应该返回 nil。如果数据被读空,没有数据可读(n == 0),则 err 应该返回 EOF。 如果遇到读取错误,则 err 应该返回相应的错误信息。

Reader扩展接口

type ReaderFrom interface {
    ReadFrom(r Reader) (n int64, err error)
}

ReaderFrom 接口包装了基本的 ReadFrom 方法,用于从 r 中读取数据存入自身。 直到遇到 EOF 或读取出错为止,返回读取的字节数和遇到的错误。

type ReaderAt interface {
    ReadAt(p []byte, off int64) (n int, err error)
}
type ByteReader interface {
    ReadByte() (c byte, err error)
}

ByteReader 接口包装了基本的 ReadByte 方法,用于从自身读出一个字节。返回读出的字节和遇到的错误。

type ByteScanner interface {
    ByteReader
    UnreadByte() error
}

ByteScanner 在 ByteReader 的基础上增加了一个 UnreadByte 方法,用于撤消最后一次的 ReadByte 操作,以便下次的 ReadByte 操作可以读出与前一次一样的数据。 UnreadByte 之前必须是 ReadByte 才能撤消成功,否则可能会返回一个错误信息(根据不同的需求,UnreadByte 也可能返回 nil,允许随意调用 UnreadByte,但只有最后一次的 ReadByte 可以被撤销,其它 UnreadByte 不执行任何操作)

type RuneReader interface {
    ReadRune() (r rune, size int, err error)
}

RuneReader 接口包装了基本的 ReadRune 方法,用于从自身读取一个 UTF-8 编码的字符到 r 中。返回读取的字符、字符的编码长度和遇到的错误。

type RuneScanner interface {
    RuneReader
    UnreadRune() error
}

RuneScanner 在 RuneReader 的基础上增加了一个 UnreadRune 方法,用于撤消最后一次的 ReadRune 操作,以便下次的 ReadRune 操作可以读出与前一次一样的数据。 UnreadRune 之前必须是 ReadRune 才能撤消成功,否则可能会返回一个错误信息(根据不同的需求,UnreadRune 也可能返回 nil,允许随意调用 UnreadRune,但只有最后一次的 ReadRune 可以被撤销,其它 UnreadRune 不执行任何操作)。

自定义实现reader接口

package main

import (
    "io"
)

type UpperString struct {
    s string
    i int64
}

func NewUpperString(s string)*UpperString{
    return &UpperString{s,0}
}

func (upperStr *UpperString)Len()int{
    if upperStr.i >= int64(len(upperStr.s)) {
        return 0
    }
    return int(int64(len(upperStr.s)) - upperStr.i)
}

func (upperStr *UpperString) Read(b []byte) (n int, err error) {
    for ; n<len(b)&&int(upperStr.i)<len(upperStr.s); upperStr.i++ {
        c := upperStr.s[upperStr.i]
        if c >= 'a' && c <= 'z' {
            c -= 'a' - 'A'
        }
        b[n] = c
        n++
    }
    if n == 0 {
        return n, io.EOF
    }
    return n, nil
}

func main() {
        str := NewUpperString("abcderghijkmnopq")
    b := make([]byte, str.Len())
    n, _ := str.Read(b)
    println(string(b[:n]))

}

Writer 接口

type Writer interface {
    Write(p []byte) (n int, err error)
}

Writer 接口包装了基本的 Write 方法,用于将数据存入自身。 Write 方法用于将 p 中的数据写入到对象的数据流中, 返回写入的字节数和遇到的错误。 如果 p 中的数据全部被写入,则 err 应该返回 nil。 如果 p 中的数据无法被全部写入,则 err 应该返回相应的错误信息。

Write扩展接口
type WriterTo interface {
    WriteTo(w Writer) (n int64, err error)
}

WriterTo 接口包装了基本的 WriteTo 方法,用于将自身的数据写入 w 中。直到数据全部写入完毕或遇到错误为止,返回写入的字节数和遇到的错误。

type WriterTo interface {
    WriteTo(w Writer) (n int64, err error)
}

WriterTo 接口包装了基本的 WriteTo 方法,用于将自身的数据写入 w 中。直到数据全部写入完毕或遇到错误为止,返回写入的字节数和遇到的错误。

type ByteWriter interface {
    WriteByte(c byte) error
}

ByteWriter 接口包装了基本的 WriteByte 方法,用于将一个字节写入自身

copy

src := strings.NewReader("1234567890")
    dst := new(strings.Builder)
    written, err := io.CopyN(dst, src, 8)
    if err != nil {
        fmt.Printf("error: %v\n", err)
    } else {
        fmt.Printf("Written(%d): %q\n", written, dst.String())
    }

os.file

O_RDONLY    //syscall.O_RDONLY(0x00000)只读
O_WRONLY    //syscall.O_WRONLY(0x00001)只写
O_RDWR      //syscall.O_RDWR(0x00002)可读可写
O_CREATE    //syscall.O_CREAT(0x00040)创建文件
O_EXCL      //syscall.O_EXCL(0x00080)配合O_CREATE使用,在创建文件时如果该文件已存在,则提示错误;open xxx: The file exists.
O_TRUNC     //syscall.O_TRUNC(0x00200)清零
O_APPEND    //syscall.O_APPEND(0x00400)续写
O_SYNC      //syscall.O_SYNC(0x01000)同步IO,表示对文件的更改会强制同步到硬盘,而不是写入缓存区后由系统写入硬盘

Closer

type Closer interface {
    Close() error
}
Closer 接口包装了基本的 Close 方法,用于关闭数据读写。
Close 一般用于关闭文件,关闭通道,关闭连接,关闭数据库等

Seeker

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

Seeker 接口包装了基本的 Seek 方法,用于移动数据的读写指针。Seek 设置下一次读写操作的指针位置,每次的读写操作都是从指针位置开始的。 whence 的含义是: 如果 whence 为 0:表示从数据的开头开始移动指针。 如果 whence 为 1:表示从数据的当前指针位置开始移动指针。 如果 whence 为 2:表示从数据的尾部开始移动指针。 offset 是指针移动的偏移量。 ret返回新指针位置

接口组合

type ReadWriter interface {
    Reader
    Writer
}

type ReadSeeker interface {
    Reader
    Seeker
}

type WriteSeeker interface {
    Writer
    Seeker
}

type ReadWriteSeeker interface {
    Reader
    Writer
    Seeker
}

type ReadCloser interface {
    Reader
    Closer
}

type WriteCloser interface {
    Writer
    Closer
}

type ReadWriteCloser interface {
    Reader
    Writer
    Closer
}

附录

方法

说明

func OpenFile(name string, flag int, perm FileMode) (*File, error)

通用文件打开函数,其中多个标志位可采取||方式携带,perm为文件权限

func Open(name string) (*File, error)

以只读方式打开文件O_RDONLY

func Create(name string) (*File, error)

创建文件,且打开文件方式为可读、可写、trunc

func (f *File) Seek(offset int64, whence int) (ret int64, err error)

返回offset,其中whence可指定offset是相对于哪里(0表示文件开头,1表示当前offset,2表示文件结尾),需要注意的是,对于以APPEND模式打开的文件,官方文档表示行为不确定。The behavior of Seek on a file opened with O_APPEND is not specified.

func (f *File) Read(b []byte) (n int, err error)

func (f *File) ReadAt(b []byte, off int64) (n int, err error)

func (f *File) Write(b []byte) (n int, err error)

func (f *File) WriteAt(b []byte, off int64) (n int, err error)

func Rename(oldname string, newname string) (err error)

//文件改名,若newname已存在则覆盖原有文件,即删除newname再将oldname改名;注意文件名可携带相对或绝对路径且更改前后文件夹路径应一致,否则会被拒绝操作;注意Windows下路径的“\”需要转义

func Chdir(dir string) error

更改当前工作文件夹

func Mkdir(name string, perm FileMode) error

创建文件夹

func Chmod(name string, mode FileMode) error

func (f *File) Chmod(mode FileMode) error

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Golang——测试与调试

    testing包提供了自动化测试相关的框架,测试源码文件的主名称通常已被测试源码文件的名字作为开头,文件名必须以xx_test.go结尾,例如我们的被测试源码文...

    羊羽shine
  • Golang包——bufio

    羊羽shine
  • C++基础变量

    变量的基本形式是:首先是类型说明符,随后紧跟有一个或者多个的变量名组成的列表,其中含有多个变量名时用逗号隔开,最后以分号结束。

    羊羽shine
  • Go语言的fmt包中文教程

    Fmt包 import "fmt" 简介 ▾ Package fmt包含有格式化I/O函数,类似于C语言的printf和scanf。格式字符串的规则来源于C但更...

    李海彬
  • Go语言的fmt包中文教程

    Fmt包 import "fmt" 简介 ▾ Package fmt包含有格式化I/O函数,类似于C语言的printf和scanf。格式字符串的规则来源于C但更...

    李海彬
  • golang flag 命令行参数解析

    copy_left
  • Go编写好的错误处理

    假设现在有个需求,返回的值是太小了还是太大了,返回不同的错误,最简单的方法直接改造GetFibonacci:

    gaobinzhan
  • 相机标定1:坐标系关系

    于是,从世界坐标系到相机坐标系,涉及到旋转和平移(其实所有的运动也可以用旋转矩阵和平移向量来描述)。绕着不同的坐标轴旋转不同的角度,得到相应的旋转矩阵,如下图所...

    yzh
  • qmake自定义函数

    Qt君
  • 采用interface实现的限时调用方法-博文

    在实时性要求高的工程项目中,对于方法执行的时间有较高的要求,本示例程序,实现了一种安全的传入任意参数的方法限时调用工具类,能执行方法的最大容忍运行时间,保证服务...

    李海彬

扫码关注云+社区

领取腾讯云代金券