Golang 中的 io.ReadAtLeast()函数示例

在 Go 语言中， io包为 I/O 原语提供基本接口。它的主要工作是封装这种原语之王的持续实现。 Go 语言中的ReadAtLeast()函数用于从指定的读取器“r”读取到指定的缓冲区“buf”，直到它至少读取了指定的最小字节数。而且，这个函数是在io包下定义的。在这里，您需要导入“io”包才能使用这些功能。

句法：

func ReadAtLeast(r Reader, buf []byte, min int) (n int, err error)

这里，“r”是所声明的阅读器，“buf”是所声明的缓冲区，而“min”是阅读器读入给定缓冲区之前的最小字节数。

返回值：返回指定缓冲区复制的字节数，如果读取的字节数小于最小字节数，则返回错误。这里，当且仅当错误为零时，返回的“n”将大于“min”字节。但是，当且仅当没有读取字节时，返回的错误是“EOF”。

注意：如果在读取的字节数少于规定的“最小”字节数后发生 EOF，则此方法返回ErrUnexpectedEOF错误。但是，如果规定的最小字节数大于规定的缓冲区的长度，则此方法返回ErrShortBuffer错误。但是，如果规定的阅读器在至少读取规定的最小字节后返回错误，则拒绝该错误。

示例 1：

// Golang program to illustrate the usage of
// io.ReadAtLeast() function
  
// Including main package
package main
  
// Importing fmt, io, and strings
import (
    "fmt"
    "io"
    "strings"
)
  
// Calling main
func main() {
  
    // Defining reader using NewReader method
    reader := strings.NewReader("Geeks")
  
    // Defining buffer of specified length
    // using make keyword
    buffer := make([]byte, 6)
  
    // Calling ReadAtLeast method with its parameters
    n, err := io.ReadAtLeast(reader, buffer, 3)
  
    // If error is not nil then panics
    if err != nil {
        panic(err)
    }
  
    // Prints output
    fmt.Printf("Number of bytes in the buffer: %d\n", n)
    fmt.Printf("Content in buffer: %s\n", buffer)
}

输出：

Number of bytes in the buffer: 5
Content in buffer: Geeks

此处，返回的“n”即 5 大于“min”即 3，因为错误为零。

示例 2：

// Golang program to illustrate the usage of
// io.ReadAtLeast() function
  
// Including main package
package main
  
// Importing fmt, io, and strings
import (
    "fmt"
    "io"
    "strings"
)
  
// Calling main
func main() {
  
    // Defining reader using NewReader method
    reader := strings.NewReader("GeeksforGeeks")
  
    // Defining buffer of specified length
    // using make keyword
    buffer := make([]byte, 4)
  
    // Calling ReadAtLeast method with its parameters
    n, err := io.ReadAtLeast(reader, buffer, 5)
  
    // If error is not nil then panics
    if err != nil {
        panic(err)
    }
  
    // Prints output
    fmt.Printf("Number of bytes in the buffer: %d\n", n)
    fmt.Printf("Content in buffer: %s\n", buffer)
}

输出：

panic: short buffer

goroutine 1 [running]:
main.main()
    /tmp/sandbox041442440/prog.go:29 +0x20f

此处，上述代码中声明的缓冲区长度小于声明的“min”字节，因此会引发错误。