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”是读取器读取到给定缓冲区之前的最小字节数。

返回值：它返回指定缓冲区复制的字节数，并且如果读取的字节数小于最小字节数，则还返回错误。在这里，当且仅当错误为nil时，返回的“n”才会大于“min”字节。但是，仅当不读取任何字节时，返回的错误是“EOF”。

注意：如果在读取少于规定的“min”字节的字节后发生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”字节，因此引发了错误。

相关用法

注：本文由纯净天空筛选整理自nidhi1352singh大神的英文原创作品 io.ReadAtLeast() Function in Golang with Examples。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。