bytes | 凉薄的自动书记人偶

API、DEMO

// 转换

// 将 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 参数相当于空 []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 是否相似，忽略大写、小写、标题三种格式的区别。
// 参考 unicode.SimpleFold 函数。
func EqualFold(s, t []byte) bool

------------------------------

// 示例：EqualFold
func main() {
	s1 := "Φφϕ kKK"
	s2 := "ϕΦφ KkK"

	// 看看 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)))
}

// 输出结果：
// 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 切分成多个子串，结果不包含分隔符。
// 如果 sep 为空，则将 s 切分成 Unicode 字符列表。
// SplitN 可以指定切分次数 n，超出 n 的部分将不进行切分。
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

------------------------------

// 示例
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（字节 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 string) 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 中出现的次数（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 转换为 []rune 类型返回
func Runes(s []byte) []rune

------------------------------------------------------------

type Reader struct { ... }

// 将 b 包装成 bytes.Reader 对象。
func NewReader(b []byte) *Reader

// bytes.Reader 实现了如下接口：
// io.ReadSeeker
// io.ReaderAt
// io.WriterTo
// io.ByteScanner
// io.RuneScanner

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

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

// 将底层数据切换为 b，同时复位所有标记（读取位置等信息）。
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 转换为 []byte 后，包装成 bytes.Buffer 对象。
func NewBufferString(s string) *Buffer

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

// bytes.Buffer 实现了如下接口：
// io.ReadWriter
// io.ReaderFrom
// io.WriterTo
// io.ByteWeriter
// io.ByteScanner
// 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 编码，返回写入的字节数和 nil。
// 保留 err 是为了匹配 bufio.Writer 的 WriteRune 方法。
func (b *Buffer) WriteRune(r rune) (n int, err error)

// 写入 s，返回写入的字节数和 nil。
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) Truncate(n int)

// 重设缓冲区，清空所有数据（包括初始内容）。
func (b *Buffer) Reset()

------------------------------

// 示例
func main() {
	rd := bytes.NewBufferString("Hello World!")
	buf := make([]byte, 6)
	// 获取数据切片
	b := rd.Bytes()
	// 读出一部分数据，看看切片有没有变化
	rd.Read(buf)
	fmt.Printf("%s\n", rd.String()) // World!
	fmt.Printf("%s\n\n", b)         // Hello World!

	// 写入一部分数据，看看切片有没有变化
	rd.Write([]byte("abcdefg"))
	fmt.Printf("%s\n", rd.String()) // World!abcdefg
	fmt.Printf("%s\n\n", b)         // Hello World!

	// 再读出一部分数据，看看切片有没有变化
	rd.Read(buf)
	fmt.Printf("%s\n", rd.String()) // abcdefg
	fmt.Printf("%s\n", b)           // Hello World!
}

bytes.buffer

bytes.buffer是一个缓冲byte类型的缓冲器

创建

func main(){
   buf1 := bytes.NewBufferString("hello")
   buf2 := bytes.NewBuffer([]byte("hello"))
   buf3 := bytes.NewBuffer([]byte{'h','e','l','l','o'})
   // 以上三者等效,输出hello
  
   buf4 := bytes.NewBufferString("")
   buf5 := bytes.NewBuffer([]byte{})
   // 以上两者等效,输出""
  
   fmt.Println(buf1.String(),buf2.String(),buf3.String(),buf4,buf5,1)
}

写入到缓冲器

Write方法，将一个byte类型的slice放到缓冲器的尾部
WriteString方法，把一个字符串放到缓冲器的尾部
WriteByte方法，将一个byte类型的数据放到缓冲器的尾部
WriteRune方法，将一个rune类型的数据放到缓冲器的尾部

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

func main(){
   s := []byte("world")
   buf := bytes.NewBufferString("hello") 
   fmt.Println(buf.String())    // hello
  
   buf.Write(s)                 // 将s这个slice添加到buf的尾部
   fmt.Println(buf.String())    // hello world
}

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

func main(){
   s := " world"
   buf := bytes.NewBufferString("hello")
   fmt.Println(buf.String())    //hello
  
   buf.WriteString(s)           //将string写入到buf的尾部
   fmt.Println(buf.String())    //hello world
}

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

func main(){
   var s byte = '?'
   buf := bytes.NewBufferString("hello") 
   fmt.Println(buf.String()) //把buf的内容转换为string，hello
   buf.WriteByte(s)         //将s写到buf的尾部
   fmt.Println(buf.String()) //hello？
}

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

func main(){
   var s rune = '好'
   buf := bytes.NewBufferString("hello")
   fmt.Println(buf.String()) //hello
   buf.WriteRune(s)   
   fmt.Println(buf.String()) //hello好
}

从缓冲器写出

WriteTo方法，将一个缓冲器的数据写到w里，w是实现io.Writer的，比如os.File

func main(){
   file,_ := os.Create("text.txt")
   buf := bytes.NewBufferString("hello world")
   buf.WriteTo(file)
   //或者使用写入，fmt.Fprintf(file,buf.String())
}

读出缓冲器

Read方法，给Read方法一个容器，读完后p就满了，缓冲器相应的减少。
ReadByte方法，返回缓冲器头部的第一个byte，缓冲器头部第一个byte取出
ReadRune方法，返回缓冲器头部的第一个rune
ReadBytes方法，需要一个byte作为分隔符，读的时候从缓冲器里找出第一个出现的分隔符，缓冲器头部开始到分隔符之间的byte返回。
ReadString方法，和ReadBytes方法一样

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

func main(){
   s1 := []byte("hello")
   buff := bytes.NewBuffer(s1)
   s2 := []byte(" world")
   buff.Write(s2)
   fmt.Println(buff.String()) //hello world
   
   s3 := make([]byte,3)
   buff.Read(s3)     //把buff的内容读入到s3，s3的容量为3，读了3个过来
   fmt.Println(buff.String()) //lo world
   fmt.Println(string(s3))   //hel
  
   buff.Read(s3) //继续读入3个，原来的被覆盖
   fmt.Println(buff.String())     //world
   fmt.Println(string(s3))    //"lo "
}

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

func main(){
   buf := bytes.NewBufferString("hello")
   fmt.Println(buf.String()) // hello
   fmt.Println(buf.String()) // hello

   b,_ := buf.ReadByte()   //取出第一个byte，赋值给b
   fmt.Println(buf.String()) //ello
   fmt.Println(string(b))   //h
}

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

func main(){
   buf := bytes.NewBufferString("你好smith")
   fmt.Println(buf.String())
  
   b,n,_ := buf.ReadRune()  //取出第一个rune
   fmt.Println(buf.String()) //好smith
   fmt.Println(string(b))   //你
   fmt.Println(n)   //3,"你“作为utf8存储占3个byte

   b,n,_ = buf.ReadRune()  //再取出一个rune
   fmt.Println(buf.String()) //smith
   fmt.Println(string(b))  //好
   fmt.Println(n)   //3
}

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

func main(){
   var d byte = 'e'  //分隔符
   buf := bytes.NewBufferString("你好esmieth")
   fmt.Println(buf.String()) //你好esmieth
  
   b,_ := buf.ReadBytes(d)  //读到分隔符，并返回给b
   fmt.Println(buf.String())  //smieth
   fmt.Println(string(b)) //你好e
}

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

func main(){
   var d byte = 'e'
   buf := bytes.NewBufferString("你好esmieth")
   fmt.Println(buf.String())  //你好esmieth
  
   b,_ := buf.ReadString(d)   //读取到分隔符，并返回给b
   fmt.Println(buf.String()) //smieth
   fmt.Println(string(b)) //你好e
}

读入缓冲器

ReadFrom方法，从一个实现io.Reader接口的r，把r的内容读到缓冲器里，n返回读的数量

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

func main(){
   file, _ := os.Open("text.txt")
   buf := bytes.NewBufferString("bob ")
   buf.ReadFrom(file)
   fmt.Println(buf.String()) //bob hello world
}

从缓冲器取出

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

func main(){
   buf := bytes.NewBufferString("hello world")
   fmt.Println(buf.String())
  
   b := buf.Next(2)  //取前2个
   fmt.Println(buf.String()) //llo world
   fmt.Println(string(b)) //he
}