golang中bytes包(转载)

golang标准库中提供了bytes包，该包几乎和strings包给string提供的功能一样，只不过bytes包对应的是[]byte。和strings一样，并不修改传入变量，而是返回其副本修改之后的内容。

整个包分为以下几种操作：转换、比较、去除、分割、查找、替换

1. 转换

将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)

将s的副本中的所有单词的首字符修改为Title格式返回。
```
func Title(s []byte) []byte
```

2. 比较

比较两个[]byte，nil参数相当于[]byte{};

//a < b   返回 -1
//a == b  返回0
//a > b   返回1
func Compare(a, b []byte) int

判断a、b是否相等，nil参数相当[]byte{}。
```
func Equal(a, b []byte) bool
```
判断s、t是否相似，忽略大写、小写、标题三种格式的区别。
```
func EqualFold(s, t []byte) bool
```

3. 去除

去除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函数中返回true的字符

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)
```
func TrimSpace(s []byte) []byte
```

去掉s副本的前缀prefix（后缀suffix）

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

4. 分割

Split函数分割
Split函数以sep为分隔符将s的副本切割分成多个子串，结果不包含分隔符。
如果sep为空，则将s的副本分割成Unicode字符列表。
SplitN可以指定分割次数，超出n的部分将不进行分割，n小于0，表示分割所有。
```
func Split(s, sep []byte) [][]byte
func SplitN(s, sep []byte, n int) [][]byte
```

功能同Split，只不过结果包含分隔符（在各个子串尾部）

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

以连续空白为分隔符将s的副本分隔成多个子串，结果不包含分隔符。
```
func Fields(s []byte) [][]byte
```
以符合f的字符为分隔符将s的副本分割成多个子串，结果不包含分割符。
```
func FieldsFunc(s []byte, f func(rune) bool) [][]byte
```
以sep为连接符，将子串列表s的副本连接成一个字节串。
```
func Join(s [][]byte, sep []byte) []byte
```
将子串b重复count次后返回。
```
func Repeat(b []byte, count int) []byte
```

5. 查找

判断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（字节c、字符r）在s中第一次出现的位置，找不到则返回-1。

func Index(s, sep []byte) int
func IndexByte(s []byte, c byte) int
func IndexRune(s []byte, r rune) int

查找chars中的任何一个字符在s中第一次出现的位置，找不到则返回-1。
```
func IndexAny(s []byte, chars strings) int
```
查找符合f的字符在s中第一次出现的位置，找不到则返回-1。
```
func IndexFunc(s []byte, f func(r rune) bool) int
```

功能同上，只不过查找最后一次出现的位置。

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中出现的次数
```
func Count(s, sep []byte) int
```

6. 替换

将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副本转换为[]rune类型返回

func Runes(s []byte) []rune

7. Reader

将切片b封装成bytes.Reader对象

func NewReader(b []byte) *Reader

bytes.Reader实现了如下接口：
1）io.ReadeSeeker
2）io.ReaderAt
3）io.WriterTo
4）io.ByteScanner
5）io.RuneScanner

// 返回未读取部分的数据长度
func (r *Reader) Len() int

// 返回底层数据的总长度，方便ReadAt使用，返回值不变。
func (r *Reader) Size() int64

8. Buffer

8.1. Buffer函数基础

Buffer是一个缓存，没有底层数据，缓存的容量会根据需要自动调整。大多数情况下，使用new(Buffer)就足以初始化一个Buffer了。

//将buf包装成bytes.Buffer对象。
type Buffer struct {...}

//转化成bytes.Buffer对象
func NewBuffer(buf []byte) *Buffer

func NewBufferString(s string) *Buffer

bytes.Buffer实现了如下接口：
1）io.ReadWrite
2）io.ReaderFrom
3）io.WriterTo
4）io.ByteWriter
5）io.ByteScanner
6）io.RuneScanner
未读取部分的数据长度
```
func (b *Buffer) Len() int
```
缓存的容量
```
func (b *Buffer) Cap() int
```
读取前n字节的数据并以切片形式返回，如果数据长度小于n，则全部读取。切片只在下一次读写操作前合法。
```
func (b *Buffer) Next(n int) []byte
```

读取第一个delim及其之前的内容，返回遇到的错误（一般是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编码，返回写入的字节数和error。保留err是为了匹配bufio.Write的WriteRune
```
func (b *Buffer) WriteRune(r rune) (n int, err error)
```

写入s，返回写入的字节数和error。

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

引用未读取部分的数据部分的数据切片（不移动读取位置）
```
func (b *Buffer) Bytes() []byte
```
返回未读取部分的数据字符串（不移动读取位置）
```
func (b *Buffer) String() string
```
自动增加缓存容量，以保证有n字节的剩余空间。如果n小于0或无法增加则会panic。
```
func (b *Buffer) Grow(n int)
```
将数据长度截短到n字节，如果n小于0或大于Cap则panic。
```
func (b *Buffer) Teuncate(n int)
```
重设缓冲区，清空所有数据（包括初始内容）。
```
func (b *Buffer) Reset
```

8.2. Buffer Write测试用例

func main() {
    //newBuffer 整形转换成字节
    var n int = 10000
    intToBytes := IntToBytes(n)
    fmt.Println("==========int to bytes========")
    fmt.Println(intToBytes)
    //NewBufferString
    TestBufferString()
    //write
    BufferWrite()
    //WriteString
    BufferWriteString()
    //WriteByte
    BufferWriteByte()
    //WriteRune
    BufferWriteRune()

}

func IntToBytes(n int) []byte {
    x := int32(n)
    //创建一个内容是[]byte的slice的缓冲器
    //与bytes.NewBufferString("")等效
    bytesBuffer := bytes.NewBuffer([]byte{})
    binary.Write(bytesBuffer, binary.BigEndian, x)
    return bytesBuffer.Bytes()
}

func TestBufferString(){
    buf1:=bytes.NewBufferString("swift")
    buf2:=bytes.NewBuffer([]byte("swift"))
    buf3:=bytes.NewBuffer([]byte{'s','w','i','f','t'})
    fmt.Println("===========以下buf1,buf2,buf3等效=========")
    fmt.Println("buf1:", buf1)
    fmt.Println("buf2:", buf2)
    fmt.Println("buf3:", buf3)
    fmt.Println("===========以下创建空的缓冲器等效=========")
    buf4:=bytes.NewBufferString("")
    buf5:=bytes.NewBuffer([]byte{})
    fmt.Println("buf4:", buf4)
    fmt.Println("buf5:", buf5)
}

func BufferWrite(){
    fmt.Println("===========以下通过Write把swift写入Learning缓冲器尾部=========")
    newBytes := []byte("swift")
    //创建一个内容Learning的缓冲器
    buf := bytes.NewBuffer([]byte("Learning"))
    //打印为Learning
    fmt.Println(buf.String())
    //将newBytes这个slice写到buf的尾部
    buf.Write(newBytes)
    fmt.Println(buf.String())
}

func BufferWriteString(){
    fmt.Println("===========以下通过Write把swift写入Learning缓冲器尾部=========")
    newString := "swift"
    //创建一个string内容Learning的缓冲器
    buf := bytes.NewBufferString("Learning")
    //打印为Learning
    fmt.Println(buf.String())
    //将newString这个string写到buf的尾部
    buf.WriteString(newString)
    fmt.Println(buf.String())
}

func BufferWriteByte(){
    fmt.Println("===========以下通过WriteByte把swift写入Learning缓冲器尾部=========")
    var newByte byte = '!'
    //创建一个string内容Learning的缓冲器
    buf := bytes.NewBufferString("Learning")
    //打印为Learning
    fmt.Println(buf.String())
    //将newString这个string写到buf的尾部
    buf.WriteByte(newByte)
    fmt.Println(buf.String())
}

func BufferWriteRune(){
    fmt.Println("===========以下通过WriteRune把\"好\"写入Learning缓冲器尾部=========")
    var newRune = '好'
    //创建一个string内容Learning的缓冲器
    buf := bytes.NewBufferString("Learning")
    //打印为Learning
    fmt.Println(buf.String())
    //将newString这个string写到buf的尾部
    buf.WriteRune(newRune)
    fmt.Println(buf.String())
}

8.3. Buffer Read测试用例

func Read(){
    bufs := bytes.NewBufferString("Learning swift.")
    fmt.Println(bufs.String())

    //声明一个空的slice,容量为8
    l := make([]byte, 8)
    //把bufs的内容读入到l内,因为l容量为8,所以只读了8个过来
    bufs.Read(l)
    fmt.Println("::bufs缓冲器内容::")
    fmt.Println(bufs.String())
    //空的l被写入了8个字符,所以为 Learning
    fmt.Println("::l的slice内容::")
    fmt.Println(string(l))
    //把bufs的内容读入到l内,原来的l的内容被覆盖了
    bufs.Read(l)
    fmt.Println("::bufs缓冲器被第二次读取后剩余的内容::")
    fmt.Println(bufs.String())
    fmt.Println("::l的slice内容被覆盖,由于bufs只有7个了,因此最后一个g被留下来了::")
    fmt.Println(string(l))

}

func ReadByte(){
    bufs := bytes.NewBufferString("Learning swift.")
    fmt.Println(bufs.String())
    //读取第一个byte,赋值给b
    b, _ := bufs.ReadByte()
    fmt.Println(bufs.String())
    fmt.Println(string(b))
}

func ReadRune(){
    bufs := bytes.NewBufferString("学swift.")
    fmt.Println(bufs.String())
    //读取第一个rune,赋值给r
    r,z,_ := bufs.ReadRune()
    //打印中文"学",缓冲器头部第一个被拿走
    fmt.Println(bufs.String())
    //打印"学","学"作为utf8储存占3个byte
    fmt.Println("r=",string(r),",z=",z)
}

func ReadBytes(){
    bufs := bytes.NewBufferString("现在开始 Learning swift.")
    fmt.Println(bufs.String())

    var delim byte = 'L'
    line, _ := bufs.ReadBytes(delim)
    fmt.Println(bufs.String())
    fmt.Println(string(line))
}

func ReadFrom(){
    //test.txt 内容是 "未来"
    file, _ := os.Open("learngo/bytes/text.txt")
    buf := bytes.NewBufferString("Learning swift.")
    buf.ReadFrom(file)              //将text.txt内容追加到缓冲器的尾部
    fmt.Println(buf.String())
}

func Reset(){
    bufs := bytes.NewBufferString("现在开始 Learning swift.")
    fmt.Println(bufs.String())

    bufs.Reset()                    //数据清空
    fmt.Println("::已经清空了bufs的缓冲内容::")
    fmt.Println(bufs.String())
}

本文摘自golang中bytes包