一、bytes.Buffer的基礎(chǔ)知識(shí)

與strings.Builder一樣，bytes.Buffer也是開箱即用的。

bytes.Buffer類型的用途主要是作為字節(jié)序列的緩沖區(qū)。

在內(nèi)部，bytes.Buffer類型使用字節(jié)切片作為內(nèi)容容器，并有一個(gè)int類型的字段作為已讀計(jì)數(shù)，這個(gè)已讀計(jì)數(shù)無法通過bytes.Buffer提供的方法計(jì)算出來。

	var buffer1 bytes.Buffer
	contents := "Simple byte buffer for marshaling data"
  // Write contents "Simple byte buffer for marshaling data"
	fmt.Printf("Write contents %q\n", contents)
	buffer1.WriteString(contents)
  // The length of buffer: 38
	fmt.Printf("The length of buffer: %d\n", buffer1.Len())
  // The capacity of buffer: 64
	fmt.Printf("The capacity of buffer: %d\n", buffer1.Cap())

與strings.Reader類型的Len方法一樣，buffer1的Len方法返回的也是內(nèi)容容器中未被讀取部分的長(zhǎng)度，而不是其中已存內(nèi)容的總長(zhǎng)度。

Buffer 值的長(zhǎng)度是未讀內(nèi)容的長(zhǎng)度，而不是已讀內(nèi)容的長(zhǎng)度。

	p1 := make([]byte, 7)
	n, _ := buffer1.Read(p1)
	// 7 bytes were read. (call Read)
	fmt.Printf("%d bytes were read. (call Read)\n", n)
	// The length of buffer: 31
	fmt.Printf("The length of buffer: %d\n", buffer1.Len())
	// The capacity of buffer: 64
	fmt.Printf("The capacity of buffer: %d\n", buffer1.Cap())

Buffer值的容量是它的內(nèi)容容器（也就是那個(gè)字節(jié)切片）的容量，它只與當(dāng)前值之上的寫操作有關(guān)，并隨著內(nèi)容的寫入而不斷增長(zhǎng)。

二、bytes.Buffer類型的值已讀計(jì)數(shù)的作用

讀取內(nèi)容時(shí)，相應(yīng)方法會(huì)依據(jù)已讀計(jì)數(shù)找到未讀內(nèi)容，并在讀取之后更新計(jì)數(shù)；

相應(yīng)方法包括所有名稱以Read開頭的方法，以及Next方法和WriteTo方法。

寫入內(nèi)容時(shí)，如需擴(kuò)容，相應(yīng)方法會(huì)根據(jù)已讀計(jì)數(shù)實(shí)現(xiàn)擴(kuò)容策略；

寫入時(shí)，如果沒有足夠的容量，就會(huì)對(duì)容器進(jìn)行擴(kuò)容。

擴(kuò)容時(shí)，方法會(huì)在必要時(shí)，依據(jù)已讀計(jì)數(shù)找到未讀部分，并把其中的內(nèi)容拷貝到擴(kuò)展容器的頭部位置。然后，方法會(huì)把已讀計(jì)數(shù)值置為0。

相應(yīng)方法包括所有名稱以Write開頭的方法，以及ReadFrom方法。

截?cái)鄡?nèi)容時(shí)，相應(yīng)方法截?cái)嗟臅r(shí)已讀計(jì)數(shù)代表索引之后的未讀部分；

截?cái)喾椒═runcate，接受一個(gè)int類型的參數(shù)，表示在截?cái)鄷r(shí)需要保留頭部多少個(gè)字節(jié)。

這里的頭部是未讀部分的頭部，而不是內(nèi)容容器的頭部。

這種情況下，已讀計(jì)數(shù)的值再加上參數(shù)值后得到的和，就是內(nèi)容容器新的總長(zhǎng)度。

讀回退時(shí)，相應(yīng)方法會(huì)使用已讀計(jì)數(shù)記錄回退點(diǎn)；

用于讀回退的方法有UnreadByte和UnreadRune。這兩個(gè)方法分別用于回退一個(gè)字節(jié)和回退一個(gè)Unicode字符。

回退的前提是，在調(diào)用它們之前的那一個(gè)操作必須是“讀取”，并且是成功的讀取，否則這些方法就只會(huì)忽略后續(xù)操作并返回一個(gè)非nil的錯(cuò)誤值。

只有緊挨在調(diào)用ReadRune方法之后，對(duì)UnreadRune方法對(duì)調(diào)用才能夠成功完成。

重置內(nèi)容時(shí)，相應(yīng)方法會(huì)把已讀計(jì)數(shù)置為0；

導(dǎo)出內(nèi)容時(shí)，相應(yīng)方法只會(huì)導(dǎo)出已讀計(jì)數(shù)代表的索引之后的未讀部分；

Buffer值的Bytes和String方法，只會(huì)訪問未讀部分的內(nèi)容，并返回相應(yīng)的結(jié)果值。

獲取長(zhǎng)度時(shí)，相應(yīng)方法會(huì)依據(jù)已讀計(jì)數(shù)和內(nèi)容容器的長(zhǎng)度，計(jì)算未讀部分的長(zhǎng)度并返回；

Buffer值的Len方法返回的是內(nèi)容容器未讀部分的長(zhǎng)度。

三、bytes.Buffer的擴(kuò)容策略

bytes.Buffer既可以手動(dòng)擴(kuò)容，也可以自動(dòng)擴(kuò)容。除非完全確定后續(xù)內(nèi)容所需的字節(jié)數(shù)，否則讓Buffer自動(dòng)擴(kuò)容就好了。這兩種方式的擴(kuò)容策略一樣。

擴(kuò)容策略：

判斷內(nèi)容容器的剩余容量，是否滿足調(diào)用方的要求，是否足夠容納新的內(nèi)容；

如果剩余容量滿足容納新的內(nèi)容，就在當(dāng)前的內(nèi)容容器之上，進(jìn)行長(zhǎng)度擴(kuò)容；

buf = buf[:length+need]

如果剩余容量不滿足容納新的內(nèi)容，就會(huì)用新的內(nèi)容容器去替代原有的內(nèi)容容器，從而實(shí)現(xiàn)擴(kuò)容；

這里有一個(gè)優(yōu)化，如果當(dāng)前內(nèi)容容器的容量的一半，仍然大于或等于現(xiàn)有長(zhǎng)度（即未讀字節(jié)數(shù)）再加上另需字節(jié)數(shù)的和，即：

cap(buf)/2 >= len(buf) + need

那么擴(kuò)容代碼就會(huì)復(fù)用現(xiàn)有的內(nèi)容容器，并把容器中的未讀內(nèi)容拷貝到它的頭部位置。

這意味著，其中的已讀內(nèi)容，將會(huì)全部被未讀內(nèi)容和之后的新內(nèi)容覆蓋掉。

如果當(dāng)前內(nèi)容容器的容量小于新長(zhǎng)度的二倍。這時(shí)，就會(huì)把原有容器中的未讀內(nèi)容拷貝進(jìn)去，最后再用新的容器替換掉原有的容器。這個(gè)新容器將會(huì)等于原有容量的二倍，再加上另需字節(jié)數(shù)的和。

新容器的容量 = 原有容量 * 2 + 所需字節(jié)數(shù)

擴(kuò)容還會(huì)把已讀計(jì)數(shù)置為0。

對(duì)于處于零值狀態(tài)的Buffer值來說，如果第一次擴(kuò)容時(shí)另需的字節(jié)數(shù)小于等于64，那么該值就會(huì)基于一個(gè)預(yù)先定義好的、長(zhǎng)度為64的字節(jié)數(shù)組來創(chuàng)建內(nèi)容容器。

這種情況下，容器的容量就是64。這樣做的目的是為了讓Buffer值在剛被真正使用的時(shí)候，可以快速的做好準(zhǔn)備。

四、bytes.Buffer的哪些方法會(huì)造成內(nèi)容的泄露

這里的內(nèi)容泄露是指，使用Buffer值的一方通過某種非標(biāo)準(zhǔn)的方式，得到本不該得到的內(nèi)容。

在bytes.Buffer中，Bytes方法和Next方法都有可能會(huì)造成內(nèi)容的泄露。原因在于，它們都把基于內(nèi)容容器的切片直接返回給了方法的調(diào)用方。

通過切片，我們可以直接訪問和操縱它們的底層數(shù)組，不論這個(gè)切片是基于某個(gè)數(shù)組得來的，還是痛哦過對(duì)另一個(gè)切片做切片操作獲得的，都是如此。

bytes.Buffer的Bytes方法和Next方法返回的字節(jié)切片，都是通過對(duì)內(nèi)容容器的切片做切片操作得到的。

	contents := "ab"
	buffer1 := bytes.NewBufferString(contents)
	// The capacity of new buffer with contents "ab": 8
	// 容量為何為8，看 runtime/string.go#stringtoslicebyte()
	fmt.Printf("The capacity of new buffer with contents %q: %d\n", contents, buffer1.Cap())
	unreadBytes := buffer1.Bytes()
	// The unread bytes of the buffer: [97 98]
	fmt.Printf("The unread bytes of the buffer: %v\n", unreadBytes)
	buffer1.WriteString("cdefg")
	// The capacity of new buffer with contents "ab": 8
	fmt.Printf("The capacity of new buffer with contents %q: %d\n", contents, buffer1.Cap())
	unreadBytes = unreadBytes[:cap(unreadBytes)]
	// 基于前面的內(nèi)容獲取到結(jié)果值
	// The unread bytes of the buffer: [97 98 99 100 101 102 103 0]
	fmt.Printf("The unread bytes of the buffer: %v\n", unreadBytes)
	// 操縱buffer
	unreadBytes[len(unreadBytes)-2] = byte('X')
	// The unread bytes of the buffer: [97 98 99 100 101 102 88 0]
	fmt.Printf("The unread bytes of the buffer: %v\n", unreadBytes)

到此這篇關(guān)于GoLang bytes.Buffer基礎(chǔ)使用方法詳解的文章就介紹到這了,更多相關(guān)Go bytes.Buffer內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論