對于傳入 []byte 的函數(shù)汁尺，都不會修改傳入的參數(shù)，返回值要么是參數(shù)的副本沛厨，要么是參數(shù)的切片。
// 轉(zhuǎn)換
// 將 s 中的所有字符修改為大寫（小寫摔认、標題）格式返回逆皮。
func ToUpper(s []byte) []byte
func ToLower(s []byte) []byte
func ToTitle(s []byte) []byte
// 使用指定的映射表將 s 中的所有字符修改為大寫（小寫、標題）格式返回参袱。
func ToUpperSpecial(_case unicode.SpecialCase, s []byte) []byte
func ToLowerSpecial(_case unicode.SpecialCase, s []byte) []byte
func ToTitleSpecial(_case unicode.SpecialCase, s []byte) []byte
// 將 s 中的所有單詞的首字符修改為 Title 格式返回电谣。
// BUG: 不能很好的處理以 Unicode 標點符號分隔的單詞。
func Title(s []byte) []byte
// 比較
// 比較兩個 []byte抹蚀，nil 參數(shù)相當于空 []byte辰企。
// a < b 返回 -1
// a == b 返回 0
// a > b 返回 1
func Compare(a, b []byte) int
// 判斷 a、b 是否相等况鸣，nil 參數(shù)相當于空 []byte牢贸。
func Equal(a, b []byte) bool
// 判斷 s、t 是否相似镐捧，忽略大寫潜索、小寫、標題三種格式的區(qū)別懂酱。
// 參考 unicode.SimpleFold 函數(shù)竹习。
func EqualFold(s, t []byte) bool
// 示例：EqualFold
func main() {
s1 := "Φφ? kK?"
s2 := "?Φφ ?kK"
// 看看 s1 里面是什么
for _, c := range s1 {
fmt.Printf("%-5x", c)
}
fmt.Println()
// 看看 s2 里面是什么
for _, c := range s2 {
fmt.Printf("%-5x", c)
}
fmt.Println()
// 看看 s1 和 s2 是否相似
fmt.Println(bytes.EqualFold([]byte(s1), []byte(s2)))
}
// 輸出結(jié)果：
// 3a6 3c6 3d5 20 6b 4b 212a
// 3d5 3a6 3c6 20 212a 6b 4b
// true
// 清理
// 去掉 s 兩邊（左邊、右邊）包含在 cutset 中的字符（返回 s 的切片）
func Trim(s []byte, cutset string) []byte
func TrimLeft(s []byte, cutset string) []byte
func TrimRight(s []byte, cutset string) []byte
// 去掉 s 兩邊（左邊列牺、右邊）符合 f 要求的字符（返回 s 的切片）
func TrimFunc(s []byte, f func(r rune) bool) []byte
func TrimLeftFunc(s []byte, f func(r rune) bool) []byte
func TrimRightFunc(s []byte, f func(r rune) bool) []byte
// 去掉 s 兩邊的空白（unicode.IsSpace）（返回 s 的切片）
func TrimSpace(s []byte) []byte
// 去掉 s 的前綴 prefix（后綴 suffix）（返回 s 的切片）
func TrimPrefix(s, prefix []byte) []byte
func TrimSuffix(s, suffix []byte) []byte
// 示例
func main() {
bs := [][]byte{
[]byte("Hello World !"),
[]byte("Hello 世界整陌！"),
[]byte("hello golang ."),
}
f := func(r rune) bool {
return bytes.ContainsRune([]byte("!！. "), r)
}
for _, b := range bs {
fmt.Printf("%q\n", bytes.TrimFunc(b, f))
}
// "Hello World"
// "Hello 世界"
// "Hello Golang"
for _, b := range bs {
fmt.Printf("%q\n", bytes.TrimPrefix(b, []byte("Hello ")))
}
// "World !"
// "世界瞎领！"
// "hello Golang ."
}
// 拆合
// Split 以 sep 為分隔符將 s 切分成多個子串泌辫，結(jié)果不包含分隔符。
// 如果 sep 為空九默，則將 s 切分成 Unicode 字符列表震放。
// SplitN 可以指定切分次數(shù) n，超出 n 的部分將不進行切分驼修。
func Split(s, sep []byte) [][]byte
func SplitN(s, sep []byte, n int) [][]byte
// 功能同 Split殿遂，只不過結(jié)果包含分隔符（在各個子串尾部）。
func SplitAfter(s, sep []byte) [][]byte
func SplitAfterN(s, sep []byte, n int) [][]byte
// 以連續(xù)空白為分隔符將 s 切分成多個子串乙各，結(jié)果不包含分隔符墨礁。
func Fields(s []byte) [][]byte
// 以符合 f 的字符為分隔符將 s 切分成多個子串，結(jié)果不包含分隔符耳峦。
func FieldsFunc(s []byte, f func(rune) bool) [][]byte
// 以 sep 為連接符恩静，將子串列表 s 連接成一個字節(jié)串。
func Join(s [][]byte, sep []byte) []byte
// 將子串 b 重復(fù) count 次后返回妇萄。
func Repeat(b []byte, count int) []byte
// 示例
func main() {
b := []byte(" Hello World ! ")
fmt.Printf("%q\n", bytes.Split(b, []byte{' '}))
// ["" "" "Hello" "" "" "World" "!" "" ""]
fmt.Printf("%q\n", bytes.Fields(b))
// ["Hello" "World" "!"]
f := func(r rune) bool {
return bytes.ContainsRune([]byte(" !"), r)
}
fmt.Printf("%q\n", bytes.FieldsFunc(b, f))
// ["Hello" "World"]
}
// 子串
// 判斷 s 是否有前綴 prefix（后綴 suffix）
func HasPrefix(s, prefix []byte) bool
func HasSuffix(s, suffix []byte) bool
// 判斷 b 中是否包含子串 subslice（字符 r）
func Contains(b, subslice []byte) bool
func ContainsRune(b []byte, r rune) bool
// 判斷 b 中是否包含 chars 中的任何一個字符
func ContainsAny(b []byte, chars string) bool
// 查找子串 sep（字節(jié) c蜕企、字符 r）在 s 中第一次出現(xiàn)的位置，找不到則返回 -1冠句。
func Index(s, sep []byte) int
func IndexByte(s []byte, c byte) int
func IndexRune(s []byte, r rune) int
// 查找 chars 中的任何一個字符在 s 中第一次出現(xiàn)的位置轻掩，找不到則返回 -1。
func IndexAny(s []byte, chars string) int
// 查找符合 f 的字符在 s 中第一次出現(xiàn)的位置懦底，找不到則返回 -1唇牧。
func IndexFunc(s []byte, f func(r rune) bool) int
// 功能同上，只不過查找最后一次出現(xiàn)的位置聚唐。
func LastIndex(s, sep []byte) int
func LastIndexByte(s []byte, c byte) int
func LastIndexAny(s []byte, chars string) int
func LastIndexFunc(s []byte, f func(r rune) bool) int
// 獲取 sep 在 s 中出現(xiàn)的次數(shù)（sep 不能重疊）丐重。
func Count(s, sep []byte) int
// 替換
// 將 s 中前 n 個 old 替換為 new，n < 0 則替換全部杆查。
func Replace(s, old, new []byte, n int) []byte
// 將 s 中的字符替換為 mapping(r) 的返回值扮惦，
// 如果 mapping 返回負值，則丟棄該字符亲桦。
func Map(mapping func(r rune) rune, s []byte) []byte
// 將 s 轉(zhuǎn)換為 []rune 類型返回
func Runes(s []byte) []rune
type Reader struct { ... }
// 將 b 包裝成 bytes.Reader 對象崖蜜。
func NewReader(b []byte) *Reader
// bytes.Reader 實現(xiàn)了如下接口：
// io.ReadSeeker
// io.ReaderAt
// io.WriterTo
// io.ByteScanner
// io.RuneScanner
// 返回未讀取部分的數(shù)據(jù)長度
func (r *Reader) Len() int
// 返回底層數(shù)據(jù)的總長度，方便 ReadAt 使用客峭，返回值永遠不變豫领。
func (r *Reader) Size() int64
// 將底層數(shù)據(jù)切換為 b，同時復(fù)位所有標記（讀取位置等信息）舔琅。
func (r *Reader) Reset(b []byte)
// 示例
func main() {
b1 := []byte("Hello World!")
b2 := []byte("Hello 世界等恐！")
buf := make([]byte, 6)
rd := bytes.NewReader(b1)
rd.Read(buf)
fmt.Printf("%q\n", buf) // "Hello "
rd.Read(buf)
fmt.Printf("%q\n", buf) // "World!"
rd.Reset(b2)
rd.Read(buf)
fmt.Printf("%q\n", buf) // "Hello "
fmt.Printf("Size:%d, Len:%d\n", rd.Size(), rd.Len())
// Size:15, Len:9
}
type Buffer struct { ... }
// 將 buf 包裝成 bytes.Buffer 對象。
func NewBuffer(buf []byte) *Buffer
// 將 s 轉(zhuǎn)換為 []byte 后备蚓，包裝成 bytes.Buffer 對象课蔬。
func NewBufferString(s string) *Buffer
// Buffer 本身就是一個緩存（內(nèi)存塊），沒有底層數(shù)據(jù)郊尝，緩存的容量會根據(jù)需要
// 自動調(diào)整购笆。大多數(shù)情況下，使用 new(Buffer) 就足以初始化一個 Buffer 了虚循。
// bytes.Buffer 實現(xiàn)了如下接口：
// io.ReadWriter
// io.ReaderFrom
// io.WriterTo
// io.ByteWeriter
// io.ByteScanner
// io.RuneScanner
// 未讀取部分的數(shù)據(jù)長度
func (b *Buffer) Len() int
// 緩存的容量
func (b *Buffer) Cap() int
// 讀取前 n 字節(jié)的數(shù)據(jù)并以切片形式返回同欠，如果數(shù)據(jù)長度小于 n，則全部讀取横缔。
// 切片只在下一次讀寫操作前合法铺遂。
func (b *Buffer) Next(n int) []byte
// 讀取第一個 delim 及其之前的內(nèi)容，返回遇到的錯誤（一般是 io.EOF）茎刚。
func (b *Buffer) ReadBytes(delim byte) (line []byte, err error)
func (b *Buffer) ReadString(delim byte) (line string, err error)
// 寫入 r 的 UTF-8 編碼襟锐，返回寫入的字節(jié)數(shù)和 nil。
// 保留 err 是為了匹配 bufio.Writer 的 WriteRune 方法膛锭。
func (b *Buffer) WriteRune(r rune) (n int, err error)
// 寫入 s粮坞，返回寫入的字節(jié)數(shù)和 nil蚊荣。
func (b *Buffer) WriteString(s string) (n int, err error)
// 引用未讀取部分的數(shù)據(jù)切片（不移動讀取位置）
func (b *Buffer) Bytes() []byte
// 返回未讀取部分的數(shù)據(jù)字符串（不移動讀取位置）
func (b *Buffer) String() string
// 自動增加緩存容量，以保證有 n 字節(jié)的剩余空間莫杈。
// 如果 n 小于 0 或無法增加容量則會 panic互例。
func (b *Buffer) Grow(n int)
// 將數(shù)據(jù)長度截短到 n 字節(jié)，如果 n 小于 0 或大于 Cap 則 panic筝闹。
func (b *Buffer) Truncate(n int)
// 重設(shè)緩沖區(qū)媳叨，清空所有數(shù)據(jù)（包括初始內(nèi)容）。
func (b *Buffer) Reset()
// 示例
func main() {
rd := bytes.NewBufferString("Hello World!")
buf := make([]byte, 6)
// 獲取數(shù)據(jù)切片
b := rd.Bytes()
// 讀出一部分數(shù)據(jù)关顷，看看切片有沒有變化
rd.Read(buf)
fmt.Printf("%s\n", rd.String()) // World!
fmt.Printf("%s\n\n", b) // Hello World!
// 寫入一部分數(shù)據(jù)糊秆，看看切片有沒有變化
rd.Write([]byte("abcdefg"))
fmt.Printf("%s\n", rd.String()) // World!abcdefg
fmt.Printf("%s\n\n", b) // Hello World!
// 再讀出一部分數(shù)據(jù)，看看切片有沒有變化
rd.Read(buf)
fmt.Printf("%s\n", rd.String()) // abcdefg
fmt.Printf("%s\n", b) // Hello World!
}
