Golang標準庫之bytes介紹

来源:https://www.cnblogs.com/huageyiyangdewo/archive/2023/06/03/17453457.html
-Advertisement-
Play Games

本次主要介紹golang中的標準庫`bytes`,基本上參考了 [位元組 | bytes](https://cloud.tencent.com/developer/section/1140520) 、[Golang標準庫——bytes](https://www.jianshu.com/p/e6f7f2 ...


本次主要介紹golang中的標準庫bytes,基本上參考了 位元組 | bytesGolang標準庫——bytes 文章。

bytes庫主要包含 5 大部分,即:

  • 常量
  • 變數
  • 函數
  • Buffer
  • Reader

我們依次學習上面的 5 大部分。

1、常量

const MinRead = 512

bytes.MinRead 是一個常量,表示在使用 ReadFrom 方法從 io.Reader 中讀取數據時,每次讀取的最小位元組數。如果 io.Reader 的 Read 方法返回的位元組數小於 bytes.MinRead,ReadFrom 方法會嘗試再次讀取,直到讀取的位元組數達到 bytes.MinRead 或者 io.EOF。這個常量的值為 512。

對上面解釋不太清楚的同學,可以去看看源碼,然後再看一看 func (b *Buffer) ReadFrom(r io.Reader) (n int64, err error) 這個方法就能夠理解了。

2、變數

// ErrTooLarge is passed to panic if memory cannot be allocated to store data in a buffer.
var ErrTooLarge = errors.New("bytes.Buffer: too large")

bytes.ErrTooLarge 是 Go 語言標準庫中 bytes 包的一個錯誤變數,表示在執行某些操作時,輸入的數據過大,超出了 bytes 包所能處理的範圍。

具體來說,當使用 bytes.Buffer 類型的 Write 方法寫入數據時,如果寫入的數據長度超過了緩衝區的容量,就會返回 bytes.ErrTooLarge 錯誤。類似地,當使用 bytes.Reader 類型的 Read 方法讀取數據時,如果要讀取的數據長度超過了緩衝區的長度,也會返回 bytes.ErrTooLarge 錯誤。

bytes.ErrTooLarge 的作用是提醒開發者註意輸入數據的大小,避免因為數據過大而導致程式崩潰或者出現其他問題。

3、函數

3.1 func Compare

函數定義:

func Compare(a, b []byte) int

Compare函數返回一個整數表示兩個[]byte切片按字典序比較的結果。如果a==b返回0;如果a<b返回-1;否則返回+1。nil參數視為空切片。

func main() {
   fmt.Println(bytes.Compare([]byte{},[]byte{})) // 0
   fmt.Println(bytes.Compare([]byte{1},[]byte{2})) // -1
   fmt.Println(bytes.Compare([]byte{2},[]byte{1})) // 1
   fmt.Println(bytes.Compare([]byte{},nil)) //0
   fmt.Println([]byte{} == nil)  // false
}

3.2 func Equal

函數定義:

func Equal(a, b []byte) bool

判斷兩個切片的內容是否完全相同。 註意:nil 參數視為空切片。

func main() {
   fmt.Println(bytes.Equal([]byte{},[]byte{})) // true
   fmt.Println(bytes.Equal([]byte{'A', 'B'},[]byte{'a'})) // false
   fmt.Println(bytes.Equal([]byte{'a'},[]byte{'a'})) // true
   fmt.Println(bytes.Equal([]byte{},nil)) // true
   fmt.Println([]byte{} == nil)  // false
}

3.3 func EqualFold

函數定義:

func EqualFold(s, t []byte) bool

判斷兩個UTF-8編碼的字元串s和t是否在Unicode的摺疊大小寫規則下相等,這種規則比簡單的大小寫不敏感更加通用。也就是說,EqualFold函數會將兩個字元串中的字元先轉換為相同的大小寫形式,再進行比較,從而判斷它們是否相等。

func main() {
    fmt.Println(bytes.EqualFold([]byte{},[]byte{})) // true
    fmt.Println(bytes.EqualFold([]byte{'A'},[]byte{'a'})) // true
    fmt.Println(bytes.EqualFold([]byte{'B'},[]byte{'a'})) // false
    fmt.Println(bytes.EqualFold([]byte{},nil)) // true
}

3.4 func Runes

函數定義:

func Runes(s []byte) []rune

Runes函數返回和s等價的[]rune切片。(將utf-8編碼的unicode碼值分別寫入單個rune)

func main() {
   fmt.Println([]byte("你好world")) // [228 189 160 229 165 189 119 111 114 108 100]
   fmt.Println(bytes.Runes([]byte("你好world"))) // [20320 22909 119 111 114 108 100]
   fmt.Println([]rune("你好world"))  // [20320 22909 119 111 114 108 100]            
}

3.5 func HasPrefix

函數定義:

func HasPrefix(s, prefix []byte) bool

判斷s是否有首碼切片prefix。

3.6 func HasSuffix

函數定義:

func HasSuffix(s, suffix []byte) bool

判斷s是否有尾碼切片suffix。

3.7 func Contains

函數定義:

func Contains(b, subslice []byte) bool

判斷切片b是否包含子切片subslice。

3.8 func Count

函數定義:

func Count(s, sep []byte) int

Count計算s中有多少個不重疊的sep子切片。

3.9 func Index

函數定義:

func Index(s, sep []byte) int

子切片sep在s中第一次出現的位置,不存在則返回-1。

3.10 func IndexByte

函數定義:

func IndexByte(s []byte, c byte) int

字元c在s中第一次出現的位置,不存在則返回-1。

3.11 func ndexRune

函數定義:

func IndexRune(s []byte, r rune) int

unicode字元r的utf-8編碼在s中第一次出現的位置,不存在則返回-1。

3.12 func IndexAny

函數定義:

func IndexAny(s []byte, chars string) int

字元串chars中的任一utf-8編碼在s中第一次出現的位置,如不存在或者chars為空字元串則返回-1

package main

import (
	"bytes"
	"fmt"
)

func main() {
	fmt.Println(bytes.IndexAny([]byte("chicken"), "aeiouy"))  // 2
	fmt.Println(bytes.IndexAny([]byte("crwth"), "aeiouy"))  // -1
}

3.13 func IndexFunc

函數定義:

func IndexFunc(s []byte, f func(r rune) bool) int

IndexFunc 將 s 解釋為一系列UTF-8編碼的Unicode代碼點。它返回滿足 f(c) 的第一個 Unicode 代碼點的 s 中的位元組索引,否則返回 -1。

package main

import (
	"bytes"
	"fmt"
	"unicode"
)

func main() {
	f := func(c rune) bool {
    // unicode.Han 代表的是 unicode 中漢字的字元集
		return unicode.Is(unicode.Han, c)
	}
	fmt.Println(bytes.IndexFunc([]byte("Hello, 世界"), f))  // 7
	fmt.Println(bytes.IndexFunc([]byte("Hello, world"), f))  // -1
}

3.14 func LastIndex

函數定義:

func LastIndex(s, sep []byte) int

切片sep在字元串s中最後一次出現的位置,不存在則返回-1。

3.15 func LastIndexAny

func LastIndexAny(s []byte, chars string) int

字元串chars中的任一utf-8字元在s中最後一次出現的位置,如不存在或者chars為空字元串則返回-1。

3.16 func LastIndexFunc

func LastIndexFunc(s []byte, f func(r rune) bool) int

s中最後一個滿足函數f的unicode碼值的位置i,不存在則返回-1。

func main() {
   fmt.Println(bytes.HasPrefix([]byte{1, 2, 3}, []byte{1})) // true
   fmt.Println(bytes.HasPrefix([]byte{1, 2, 3}, []byte{2})) // false

   fmt.Println(bytes.HasSuffix([]byte{1, 2, 3, 3}, []byte{3, 3}))  // true
   fmt.Println(bytes.HasSuffix([]byte{1, 2, 3, 3}, []byte{3, 4}))  // false

   fmt.Println(bytes.Contains([]byte{1, 2, 3}, []byte{1}))    // true
   fmt.Println(bytes.Contains([]byte{1, 2, 3}, []byte{1, 3})) // false

   fmt.Println(bytes.Index([]byte{1, 2, 3, 4, 5}, []byte{4, 5})) // 3
   fmt.Println(bytes.Index([]byte{1, 2, 3, 4, 5}, []byte{0, 1})) // -1

   fmt.Println(bytes.IndexByte([]byte{1, 2, 3}, 3)) // 2
   fmt.Println(bytes.IndexByte([]byte{1, 2, 3}, 0)) // -1

   fmt.Println(bytes.LastIndex([]byte("hi go"), []byte("go"))) // 3
   fmt.Println(bytes.LastIndex([]byte{1, 2, 3}, []byte{2, 3})) // 1

   fmt.Println(bytes.IndexAny([]byte("hi go"), "go")) // 3

   fmt.Println(bytes.Count([]byte("hi go go go go go go go go go"), []byte("go"))) // 9

   fmt.Println(bytes.IndexRune([]byte("你好嗎,不太好啊,hi go go go go go go go go go"), '不')) // 9

   fmt.Println(bytes.IndexFunc([]byte("hi go"), func(r rune) bool {
      return r == 'g'
   })) // 3
}

3.17 func Title

func Title(s []byte) []byte

返回s中每個單詞的首字母都改為標題格式的拷貝。

BUG: Title用於劃分單詞的規則不能很好的處理Unicode標點符號。

fmt.Printf("%s\n", bytes.Title([]byte("her royal highness")))  // Her Royal Highness
fmt.Printf("%s\n", bytes.Title([]byte("hEr royal highness")))  // HEr Royal Highness

3.18 func ToLower

func ToLower(s []byte) []byte

返回將所有字母都轉為對應的小寫版本的拷貝。

fmt.Printf("%s", bytes.ToLower([]byte("Gopher")))  // gopher

3.19 func ToLowerSpecial

func ToLowerSpecial(_case unicode.SpecialCase, s []byte) []byte

ToLowerSpecial 將 s 視為 UTF-8 編碼的位元組並返回一個副本,其中所有 Unicode 字母都映射到它們的小寫,優先考慮特殊的大小寫規則。

package main

import (
    "bytes"
    "fmt"
    "unicode"
)

func main() {
    str := []byte("AHOJ VÝVOJÁRİ GOLANG")
    totitle := bytes.ToLowerSpecial(unicode.AzeriCase, str)
    fmt.Println("Original : " + string(str))
    fmt.Println("ToLower : " + string(totitle))
}

結果:

Original : AHOJ VÝVOJÁRİ GOLANG
ToLower : ahoj vývojári golang

3.20 func ToUpper

func ToUpper(s []byte) []byte

返回將所有字母都轉為對應的大寫版本的拷貝。

3.21 func ToUpperSpecial

func ToUpperSpecial(_case unicode.SpecialCase, s []byte) []byte

使用_case規定的字元映射,返回將所有字母都轉為對應的大寫版本的拷貝。

3.22 func ToTitle

func ToTitle(s []byte) []byte

返回將所有字母都轉為對應的標題版本的拷貝。

3.23 func ToTitleSpecial

func ToTitleSpecial(_case unicode.SpecialCase, s []byte) []byte

使用_case規定的字元映射,返回將所有字母都轉為對應的標題版本的拷貝。

func main() {
   fmt.Println(string(bytes.Title([]byte("AAA")))) // AAA
   fmt.Println(string(bytes.Title([]byte("aaa")))) // Aaa

   fmt.Println(string(bytes.ToTitle([]byte("Aaa")))) // AAA

   fmt.Println(string(bytes.ToUpper([]byte("Aaa")))) // AAA
   fmt.Println(string(bytes.ToUpperSpecial(unicode.SpecialCase{}, []byte("Aaa")))) // AAA

   fmt.Println(string(bytes.ToLower([]byte("aAA")))) // aaa
   fmt.Println(string(bytes.ToLowerSpecial(unicode.SpecialCase{}, []byte("aAA")))) // aaa
}

3.24 func Repeat

func Repeat(b []byte, count int) []byte

返回count個b串聯形成的新的切片。

3.25 func Replace

func Replace(s, old, new []byte, n int) []byte

返回將 s 中 前n個 不重疊 old切片序列 都替換為 new 的新的切片拷貝,如果n<0會替換所有old子切片。

package main

import (
	"bytes"
	"fmt"
)

func main() {
	fmt.Printf("%s\n", bytes.Replace([]byte("oink oink oink"), []byte("k"), []byte("ky"), 2))
	fmt.Printf("%s\n", bytes.Replace([]byte("oink oink oink"), []byte("oink"), []byte("moo"), -1))
}

結果:

oinky oinky oink
moo moo moo

3.26 func Map

func Map(mapping func(r rune) rune, s []byte) []byte

Map 根據映射函數返回位元組切片s的所有字元修改後的副本。如果映射返回負值,則字元將從字元串中刪除而不會被替換。 s 和輸出中的字元被解釋為 UTF-8 編碼的 Unicode 代碼點。

package main

import (
	"bytes"
	"fmt"
)

func main() {
	rot13 := func(r rune) rune {
		switch {
		case r >= 'A' && r <= 'Z':
			return 'A' + (r-'A'+13)%26
		case r >= 'a' && r <= 'z':
			return 'a' + (r-'a'+13)%26
		}
		return r
	}
	fmt.Printf("%s", bytes.Map(rot13, []byte("'Twas brillig and the slithy gopher...")))
}

//  輸出
'Gjnf oevyyvt naq gur fyvgul tbcure...

3.27 func Trim

func Trim(s []byte, cutset string) []byte

返回將s前後端所有cutset包含的unicode碼值都去掉的子切片。(共用底層數組)

3.28 func TrimSpace

func TrimSpace(s []byte) []byte

返回將s前後端所有空白(unicode.IsSpace指定)都去掉的子切片。(共用底層數組)

3.29 func TrimFunc

func TrimFunc(s []byte, f func(r rune) bool) []byte

返回將s前後端所有滿足f的unicode碼值都去掉的子切片。(共用底層數組)

3.30 func TrimLeft

func TrimLeft(s []byte, cutset string) []byte

返回將s前端所有cutset包含的unicode碼值都去掉的子切片。(共用底層數組)

3.31 func TrimLeftFunc

func TrimLeftFunc(s []byte, f func(r rune) bool) []byte

返回將s前端所有滿足f的unicode碼值都去掉的子切片。(共用底層數組)

3.32 func TrimPrefix

func TrimPrefix(s, prefix []byte) []byte

返回去除s可能的首碼prefix的子切片。(共用底層數組)

3.33 func TrimRight

func TrimRight(s []byte, cutset string) []byte

返回將s後端所有cutset包含的unicode碼值都去掉的子切片。(共用底層數組)

3.34 func TrimRightFunc

func TrimRightFunc(s []byte, f func(r rune) bool) []byte

返回將s後端所有滿足f的unicode碼值都去掉的子切片。(共用底層數組)

3.35 func TrimSuffix

func TrimSuffix(s, suffix []byte) []byte

返回去除s可能的尾碼suffix的子切片。(共用底層數組)

func main() {
   fmt.Println(bytes.Repeat([]byte{1,2},3)) // [1 2 1 2 1 2]

   fmt.Println(bytes.Replace([]byte{1,2,1,2,3,1,2,1,2}, []byte{1,2}, []byte{0,0},3)) // [0 0 0 0 3 0 0 1 2]

   fmt.Println(string(bytes.Map(func(r rune) rune {
      return r + 1 // 將每一個字元都+1
   },[]byte("abc")))) // bcd

   fmt.Println(string(bytes.Trim([]byte("hello my"), "my")))  // hello 

   fmt.Println(string(bytes.TrimSpace([]byte(" hello my bro "))))   // hello my bro

   fmt.Println(string(bytes.TrimLeft([]byte("hi hi go"), "hi"))) //  hi go
   fmt.Println(string(bytes.TrimPrefix([]byte("hi hi go"),[]byte("hi")))) //  hi go
   fmt.Println(string(bytes.TrimSuffix([]byte("hi go go"),[]byte("go")))) // hi go
}

3.36 func Fields

func Fields(s []byte) [][]byte

返回將字元串按照空白(unicode.IsSpace確定,可以是一到多個連續的空白字元)分割的多個子切片。如果字元串全部是空白或者是空字元串的話,會返回空切片。

3.37 func FieldsFunc

func FieldsFunc(s []byte, f func(rune) bool) [][]byte

類似Fields,但使用函數f來確定分割符(滿足f的utf-8碼值)。如果字元串全部是分隔符或者是空字元串的話,會返回空切片。

3.38 func Split

func Split(s, sep []byte) [][]byte

用去掉s中出現的sep的方式進行分割,會分割到結尾,並返回生成的所有[]byte切片組成的切片(每一個sep都會進行一次切割,即使兩個sep相鄰,也會進行兩次切割)。如果sep為空字元,Split會將s切分成每一個unicode碼值一個[]byte切片。

3.39 func SplitN

func SplitN(s, sep []byte, n int) [][]byte

用去掉s中出現的sep的方式進行分割,會分割到最多n個子切片,並返回生成的所有[]byte切片組成的切片(每一個sep都會進行一次切割,即使兩個sep相鄰,也會進行兩次切割)。如果sep為空字元,Split會將s切分成每一個unicode碼值一個[]byte切片。參數n決定返回的切片的數目:

n > 0 : 返回的切片最多n個子字元串;最後一個子字元串包含未進行切割的部分。
n == 0: 返回nil
n < 0 : 返回所有的子字元串組成的切片

3.40 func SplitAfter

func SplitAfter(s, sep []byte) [][]byte

用從s中出現的sep後面切斷的方式進行分割,會分割到結尾,並返回生成的所有[]byte切片組成的切片(每一個sep都會進行一次切割,即使兩個sep相鄰,也會進行兩次切割)。如果sep為空字元,Split會將s切分成每一個unicode碼值一個[]byte切片。

3.41 func SplitAfterN

func SplitAfterN(s, sep []byte, n int) [][]byte

用從s中出現的sep後面切斷的方式進行分割,會分割到最多n個子切片,並返回生成的所有[]byte切片組成的切片(每一個sep都會進行一次切割,即使兩個sep相鄰,也會進行兩次切割)。如果sep為空字元,Split會將s切分成每一個unicode碼值一個[]byte切片。參數n決定返回的切片的數目:

n > 0 : 返回的切片最多n個子字元串;最後一個子字元串包含未進行切割的部分。
n == 0: 返回nil
n < 0 : 返回所有的子字元串組成的切片

3.42 func Join

func Join(s [][]byte, sep []byte) []byte

將一系列[]byte切片連接為一個[]byte切片,之間用sep來分隔,返回生成的新切片。

func main() {
   s := bytes.Fields([]byte(" hi 你啊,    is not good, my boy"))
   for _,v := range s {
      fmt.Print(string(v) + "|")// hi|你啊,|is|not|good,|my|boy|
   }
   fmt.Println()

   s = bytes.FieldsFunc([]byte(" hi 你啊,    is-not.good, my,boy"),func(r rune) bool {
      return r == ','||r == '-'||r == '.' // 只要是,-. 都可以作為分隔符
   })
   for _,v := range s {
      fmt.Print(string(v)+"|")//  hi 你啊|    is|not|good| my|boy|
   }
   fmt.Println()

   s = bytes.Split([]byte(" hi 你啊,    is not good, is my boy"),[]byte("is"))
   for _,v := range s {
      fmt.Print(string(v) + "|")//  |  hi 你啊,    | not good, | my boy|
   }
   fmt.Println()

   fmt.Println(bytes.Join([][]byte{{1,1},{2,2},{3,3}},[]byte{9})) // [1 1 9 2 2 9 3 3]
}

4、type Reader

type Reader struct {
   s        []byte // 存儲數據的byte切片
   i        int64 // current reading index => 當前讀到的位置
   prevRune int   // index of previous rune; or < 0 => 前一個rune的索引
}

Reader類型通過從一個[]byte讀取數據,實現了io.Reader、io.Seeker、io.ReaderAt、io.WriterTo、io.ByteScanner、io.RuneScanner介面。

4.1 func NewReader

func NewReader(b []byte) *Reader

NewReader創建一個從b讀取數據的Reader。

4.2 func (*Reader) Len

func (r *Reader) Len() int

Len返回r包含的切片中還沒有被讀取的部分。

4.3 func (*Reader) Read

func (r *Reader) Read(b []byte) (n int, err error)

從 r 中讀取位元組到 b 中

package main

import (
	"bytes"
	"fmt"
)

func main()  {
	r := bytes.NewBufferString("hello world")
	fmt.Printf("r.Len()  -> %d\n", r.Len())
	m := make([]byte, 5)
	r.Read(m)
	fmt.Printf("r.Len()  -> %d\n", r.Len())
	fmt.Printf("%s\n", m)
}

// 結果
r.Len()  -> 11
r.Len()  -> 6
hello

4.4 func (*Reader) ReadByte

func (r *Reader) ReadByte() (b byte, err error)

讀取一個位元組

package main

import (
	"bytes"
	"fmt"
)

func main() {
	r := bytes.NewBufferString("hello world")
	fmt.Printf("%v\n", r.Bytes())
	fmt.Printf("r.Len()  -> %d\n", r.Len())
	//m := make([]byte, 5)
	a, err := r.ReadByte()
	fmt.Printf("r.Len()  -> %d\n", r.Len())
	fmt.Printf("%v \n", a)
	fmt.Println(err)
}

// 結果
[104 101 108 108 111 32 119 111 114 108 100]
r.Len()  -> 11
r.Len()  -> 10
104 
<nil>

4.5 func (*Reader) UnreadByte

func (r *Reader) UnreadByte() error

4.6 func (*Reader) ReadRune

func (r *Reader) ReadRune() (ch rune, size int, err error)

4.7 func (*Reader) UnreadRune

func (r *Reader) UnreadRune() error

如果上一個操作不是 ReadRune ,將報錯。

如果是,將 ReadRune 讀取的影響複位。這裡執行下看看結果就明白意思了。

package main

import (
	"bytes"
	"fmt"
)

func main() {
	r := bytes.NewBufferString("hello world")
	fmt.Printf("%v\n", r.Bytes())
	fmt.Printf("r.Len()  -> %d\n", r.Len())
	
	s, b, err := r.ReadRune()
	fmt.Println(s, b, err)
	//err = r.UnreadRune()
	fmt.Println(err)
	fmt.Println(r.Bytes())
}

4.8 func (*Reader) Seek

func (r *Reader) Seek(offset int64, whence int) (int64, error)

Seek實現了io.Seeker介面。

package main

import (
	"fmt"
	"strings"
)

func main() {
	reader := strings.NewReader("Go語言學習園地")
	reader.Seek(2, 0)
	r, _, _ := reader.ReadRune()
	fmt.Printf("%c\n", r)

}

// 結果
語

4.9 func (*Reader) ReadAt

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

4.10 func (*Reader) WriteTo

func (r *Reader) WriteTo(w io.Writer) (n int64, err error)

WriteTo實現了io.WriterTo介面。

func main() {
   r := bytes.NewReader([]byte("ABCDEFGHIJKLMN IIIIII LLLLLLLL SSSSSS"))

   fmt.Println(r.Len()) // 37
   fmt.Println(r.Size()) // 37

   tmp := make([]byte,5)
   n,_ := r.Read(tmp)
   fmt.Println(string(tmp[:n])) // ABCDE
   fmt.Println(r.Len(),r.Size()) // 32 37

   fmt.Println(r.ReadByte()) // 70 <nil> // F
   fmt.Println(r.ReadRune()) // 71 1 <nil>
   fmt.Println(r.Len(),r.Size()) // 30 37

   b := []byte("III")     // cap 3
   n,_ = r.ReadAt(b,1)   
   fmt.Println(string(b),n)   // BCD 3

   r.Reset([]byte("Hi,My god"))
   fmt.Println(r.Len(),r.Size()) // 9 9

   r.WriteTo(os.Stdout)  // Hi,My god
}

5、type Buffer

type Buffer struct {
   buf      []byte // contents are the bytes buf[off : len(buf)] => buffer的數據
   off      int    // read at &buf[off], write at &buf[len(buf)] => buffer的目前讀取到的位置
   lastRead readOp // last read operation, so that Unread* can work correctly. => 最後一次的讀取操作
}

Buffer是一個實現了讀寫方法的可變大小的位元組緩衝。本類型的零值是一個空的可用於讀寫的緩衝。

5.1 func NewBuffer

func NewBuffer(buf []byte) *Buffer

NewBuffer使用buf作為初始內容創建並初始化一個Buffer。本函數用於創建一個用於讀取已存在數據的buffer;也用於指定用於寫入的內部緩衝的大小,此時,buf應為一個具有指定容量但長度為0的切片。buf會被作為返回值的底層緩衝切片。

大多數情況下,new(Buffer)(或只是聲明一個Buffer類型變數)就足以初始化一個Buffer了。

5.2 func NewBufferString

func NewBufferString(s string) *Buffer

NewBuffer使用s作為初始內容創建並初始化一個Buffer。本函數用於創建一個用於讀取已存在數據的buffer。

大多數情況下,new(Buffer)(或只是聲明一個Buffer類型變數)就足以初始化一個Buffer了。

第一種方式
buffer := new(bytes.Buffer) // 使用new函數
第二種方式
buffer := bytes.NewBuffer([]byte{}) // 使用bytes包的NewBuffer函數
第三種方式
buffer := bytes.NewBufferString("") // 使用bytes包的NewBufferString函數

5.3 func (*Buffer) Len

func (b *Buffer) Len() int

返回緩衝中未讀取部分的位元組長度;b.Len() == len(b.Bytes())。

5.4 func (*Buffer) Bytes

func (b *Buffer) Bytes() []byte

返回未讀取部分位元組數據的切片,len(b.Bytes()) == b.Len()。如果中間沒有調用其他方法,修改返回的切片的內容會直接改變Buffer的內容。

5.5 func (*Buffer) String

func (b *Buffer) String() string

將未讀取部分的位元組數據作為字元串返回,如果b是nil指針,會返回空字元串。

5.6 func (*Buffer) Grow

func (b *Buffer) Grow(n int)

必要時會增加緩衝的容量,以保證n位元組的剩餘空間。調用Grow(n)後至少可以向緩衝中寫入n位元組數據而無需申請記憶體。如果n小於零或者不能增加容量都會panic。

5.7 func (*Buffer) Read

func (b *Buffer) Read(p []byte) (n int, err error)

Read方法從緩衝中讀取數據直到緩衝中沒有數據或者讀取了len(p)位元組數據,將讀取的數據寫入p。返回值n是讀取的位元組數,除非緩衝中完全沒有數據可以讀取並寫入p,此時返回值err為io.EOF;否則err總是nil。

5.8 func (*Buffer) Next

func (b *Buffer) Next(n int) []byte

返回未讀取部分前n位元組數據的切片,並且移動讀取位置,就像調用了Read方法一樣。如果緩衝內數據不足,會返回整個數據的切片。切片只在下一次調用b的讀/寫方法前才合法。

5.9 func (*Buffer) ReadByte

func (b *Buffer) ReadByte() (c byte, err error)

ReadByte讀取並返回緩衝中的下一個位元組。如果沒有數據可用,返回值err為io.EOF。

5.10 func (*Buffer) UnreadByte

func (b *Buffer) UnreadByte() error

UnreadByte吐出最近一次讀取操作讀取的最後一個位元組。如果最後一次讀取操作之後進行了寫入,本方法會返回錯誤。

5.11 func (*Buffer) ReadRune

func (b *Buffer) ReadRune() (r rune, size int, err error)

ReadRune讀取並返回緩衝中的下一個utf-8碼值。如果沒有數據可用,返回值err為io.EOF。如果緩衝中的數據是錯誤的utf-8編碼,本方法會吃掉一位元組並返回(U+FFFD, 1, nil)。

5.12 func (*Buffer) UnreadRune

func (b *Buffer) UnreadRune() error

UnreadRune吐出最近一次調用ReadRune方法讀取的unicode碼值。如果最近一次讀寫操作不是ReadRune,本方法會返回錯誤。(這裡就能看出來UnreadRune比UnreadByte嚴格多了)

5.13 func (*Buffer) ReadBytes

func (b *Buffer) ReadBytes(delim byte) (line []byte, err error)

ReadBytes讀取直到第一次遇到delim位元組,返回一個包含已讀取的數據和delim位元組的切片。如果ReadBytes方法在讀取到delim之前遇到了錯誤,它會返回在錯誤之前讀取的數據以及該錯誤(一般是io.EOF)。當且僅當ReadBytes方法返回的切片不以delim結尾時,會返回一個非nil的錯誤。

5.14 func (*Buffer) ReadString

func (b *Buffer) ReadString(delim byte) (line string, err error)

ReadString讀取直到第一次遇到delim位元組,返回一個包含已讀取的數據和delim位元組的字元串。如果ReadString方法在讀取到delim之前遇到了錯誤,它會返回在錯誤之前讀取的數據以及該錯誤(一般是io.EOF)。當且僅當ReadString方法返回的切片不以delim結尾時,會返回一個非nil的錯誤。

func main() {
   b := bytes.NewBufferString("ABCDEFGH")

   fmt.Println(b.String()) // ABCDEFGH

   fmt.Println(b.Len()) // 8

   fmt.Println(string(b.Next(2))) // AB
   tmp := make([]byte,2)

   n,_ := b.Read(tmp)
   fmt.Println(string(tmp[:n])) //CD

   nextByte,_ := b.ReadByte()
   fmt.Println(string(nextByte)) // E

   line,_ := b.ReadString('G')
   fmt.Println(line) // FG
   fmt.Println(b.String()) // H
   b = bytes.NewBufferString("abcdefgh")

   line2,_ := b.ReadBytes('b')
   fmt.Println(string(line2)) // ab
   fmt.Println(b.String()) // cdefgh

   r,n,_ := b.ReadRune()
   fmt.Println(r,n) // 99 1

   fmt.Println(string(b.Bytes())) // defgh
}

5.15 func (*Buffer) Write

func (b *Buffer) Write(p []byte) (n int, err error)

Write將p的內容寫入緩衝中,如必要會增加緩衝容量。返回值n為len(p),err總是nil。如果緩衝變得太大,Write會採用錯誤值ErrTooLarge引發panic。

5.16 func (*Buffer) WriteString

func (b *Buffer) WriteString(s string) (n int, err error)

Write將s的內容寫入緩衝中,如必要會增加緩衝容量。返回值n為len(p),err總是nil。如果緩衝變得太大,Write會採用錯誤值ErrTooLarge引發panic。

5.17 func (*Buffer) WriteByte

func (b *Buffer) WriteByte(c byte) error

WriteByte將位元組c寫入緩衝中,如必要會增加緩衝容量。返回值總是nil,但仍保留以匹配bufio.Writer的WriteByte方法。如果緩衝太大,WriteByte會採用錯誤值ErrTooLarge引發panic。

5.18 func (*Buffer) WriteRune

func (b *Buffer) WriteRune(r rune) (n int, err error)

WriteByte將unicode碼值r的utf-8編碼寫入緩衝中,如必要會增加緩衝容量。返回值總是nil,但仍保留以匹配bufio.Writer的WriteRune方法。如果緩衝太大,WriteRune會採用錯誤值ErrTooLarge引發panic。

5.19 func (*Buffer) ReadFrom

func (b *Buffer) ReadFrom(r io.Reader) (n int64, err error)

ReadFrom從r中讀取數據直到結束並將讀取的數據寫入緩衝中,如必要會增加緩衝容量。返回值n為從r讀取並寫入b的位元組數;會返回讀取時遇到的除了io.EOF之外的錯誤。如果緩衝太大,ReadFrom會採用錯誤值ErrTooLarge引發panic。

5.20 func (*Buffer) WriteTo

func (b *Buffer) WriteTo(w io.Writer) (n int64, err error)

WriteTo從緩衝中讀取數據直到緩衝內沒有數據或遇到錯誤,並將這些數據寫入w。返回值n為從b讀取並寫入w的位元組數;返回值總是可以無溢出的寫入int類型,但為了匹配io.WriterTo介面設為int64類型。從b讀取是遇到的非io.EOF錯誤及寫入w時遇到的錯誤都會終止本方法並返回該錯誤。

5.21 func (*Buffer) Truncate

func (b *Buffer) Truncate(n int)

丟棄緩衝中除前n位元組數據外的其它數據,如果n小於零或者大於緩衝容量將panic。

5.22 func (*Buffer) Reset

func (b *Buffer) Reset()

Reset重設緩衝,因此會丟棄全部內容,等價於b.Truncate(0)

func main() {
   b := new(bytes.Buffer)

   b.WriteByte('a')
   fmt.Println(b.String()) // a

   b.Write([]byte{98,99})
   fmt.Println(b.String()) // abc

   b.WriteString(" hello")
   fmt.Println(b.String()) // abc hello

   b.Truncate(3)
   fmt.Println(b.String()) // abc
   
   n,_ := b.WriteTo(os.Stdout) // abc
   fmt.Println(n) // 3

   b.Reset()
   fmt.Println(b.Len(),b.String()) // 0
}

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 原文地址: [Android Studio歷史版本下載地址彙總 - Stars-One的雜貨小窩](https://stars-one.site/2023/06/03/android-studio-version-list) > 由於新公司不給自帶電腦,然後給了台新的電腦,於是就是需要重新下載And ...
  • 這裡給大家分享我在網上總結出來的一些知識,希望對大家有所幫助 前言 所謂數據可視化,我們可以理解為從巨集觀角度來看一眼就能看出來整個數據的占比,走向。對於數據可視化,很多互聯網公司是很看重這一塊的,包括大廠;就比如阿裡的淘寶,雙十一的時候往往就需要將消費者的一些數據通過圖的形式展現出來。接下來我們就來 ...
  • ## 為什麼要引入 husky? 雖然我們項目中引入了`prettier`和`eslint`對代碼格式進行了校驗,但是多人開發的時候難免依然會有人提交不符合規範的代碼到倉庫中,如果我們拉取到這種代碼還得慢慢對其進行修改,這是一件很麻煩的事情,同時也為了避免團隊成員提交五花八門message,因此我們 ...
  • #TCP/IP協議原理 TCP/IP協議是Internet互聯網最基本的協議,TCP/IP協議的應用層的主要協議有HTTP、Telnet、FTP、SMTP等,是用來讀取來自傳輸層的數據或者將數據傳輸寫入傳輸層;傳輸層的主要協議有UDP、TCP,實現端對端的數據傳輸;網路層的主要協議有ICMP、IP、 ...
  • # 1.列表數據元素排序 在創建的列表中,數據元素的排列順序常常是無法預測的。這雖然在大多數情況下都是不可避免的,但經常需要以特定的順序呈現信息。有時候希望保留列表數據元素最初的排列順序,而有時候又需要調整排列順序。python提供了很多列表數據元素排序的方式,可根據情況選用。 ## 1.永久性排序 ...
  • 本篇專門扯一下有關 QCheckBox 組件的一個問題。老周不水字數,直接上程式,你看了就明白。 #include <QApplication> #include <QWidget> #include <QPushButton> #include <QCheckBox> #include <QVBo ...
  • # 2022版本IDEA+Maven+Tomcat的第一個程式(傻瓜教學) ​ 作為學習Javaweb的一個重要環節,如何實現在IDEA中利用Maven工具創建一個Javaweb程式模版並連接Tomcat發佈是非常重要的。我比較愚鈍(小白),而且自身電腦先前運行過spring或maven的程式,系統 ...
  • 歡迎來到本篇文章!通過上一篇什麼是 Spring?為什麼學它?的學習,我們知道了 Spring 的基本概念,知道什麼是 Spring,以及為什麼學習 Spring。今天,這篇就來說說 Spring 中的核心概念之一 IoC。 ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...