Golang 中的 Strings 包詳解之 Strings.Reader
strings.Reader
strings.Reader 是一個實現了 io.Reader、io.Writer、io.ByteReader、io.ByteScanner、io.RuneReader 、io.RuneScanner,、io.Seeker 和 io.WriterTo 接口的結構體,用于從字符串中高效讀取數據。strings.Reader 可以將一個字符串包裝成一個可讀流,方便地將字符串中的數據讀取到應用程序中。結構體定義和對應的方法如下:
type Reader struct {
s string
i int64 // current reading index
prevRune int // index of previous rune; or < 0
}
func (r *Reader) Len() int
func (r *Reader) Size() int64
func (r *Reader) Read(b []byte) (n int, err error)
func (r *Reader) ReadAt(b []byte, off int64) (n int, err error)
func (r *Reader) ReadByte() (byte, error)
func (r *Reader) UnreadByte() error
func (r *Reader) ReadRune() (ch rune, size int, err error)
func (r *Reader) UnreadRune() error
func (r *Reader) Seek(offset int64, whence int)
func (r *Reader) WriteTo(w io.Writer) (n int64, err error)
func (r *Reader) Reset(s string)
func NewReader(s string) *Reader
其中比較常用的方法有:
- NewReader() :返回一個從字符串 s 中讀取數據的 *Reader。
- Read(b []byte) (n int, err error): 從 strings.Reader 中讀取 len(b) 個字節, 存入 b 中,返回實際讀取的字節數和可能發生的錯誤。
- func (r *Reader) Len() int: 返回還有多少字節可以被讀取。
優勢
可以看到,strings.Reader 包含了一個字符串、當前讀取的位置索引和一個內部實現的可讀流。strings.Reader 類型可以很方便高效地讀取一個字符串中的內容,在讀取的過程中,Reader 會保存已讀取位置索引,位置索引就是下一次讀取的起始位置索引。Reader正是依靠這樣一個位置索引以及針對字符串值的切片表達式來實現快速讀取的。
使用示例
簡單使用示例如下:
package main
import (
"fmt"
"strings"
)
func main() {
// 創建一個 strings.Reader 實例
r := strings.NewReader("路多辛的所思所想")
// 讀取數據
b := make([]byte, 9)
n, err := r.Read(b)
if err != nil {
fmt.Println("讀取數據失敗:", err)
return
}
fmt.Printf("讀取了 %d 個字節:%s\n", n, string(b[:n]))
}
運行示例代碼,輸出如下:
$ go run main.go
讀取了 9 個字節:路多辛
通過 strings.NewReader 創建了一個 strings.Reader 實例后,可以使用 Read 方法從字符串中讀取數據。由于 strings.Reader 實現了 io.Reader 接口,因此可以使用各種基于 io.Reader 的流式處理方法,比如 io.LimitReader、io.PipeReader 等。
小結
strings.Reader 實現了 io.Reader、io.Writer、io.ByteReader、io.ByteScanner、io.RuneReader 、io.RuneScanner,、io.Seeker 和 io.WriterTo 接口,所以可以方便地讀取和處理字符串數據。
strings.Reader 讀取字符串也很高效,主要體現在對字符串的讀取機制上。在讀取的過程中,會保存當前讀取的位置索引,位置索引就是下一次讀取的起始位置索引。