Go基础篇【第8篇】: 内置库模块 bytes [一]

bytes包实现了操作[]byte的常用函数。本包的函数和strings包的函数相当类似。

func Compare

func Compare(a, b []byte) int

Compare函数返回一个整数表示两个[]byte切片按字典序比较的结果（类同C的strcmp）。如果a==b返回0；如果a<b返回-1；否则返回+1。nil参数视为空切片。

func Equal

func Equal(a, b []byte) bool

判断两个切片的内容是否完全相同。

func EqualFold

func EqualFold(s, t []byte) bool

判断两个utf-8编码切片（将unicode大写、小写、标题三种格式字符视为相同）是否相同。

func Runes

func Runes(s []byte) []rune

Runes函数返回和s等价的[]rune切片。（将utf-8编码的unicode码值分别写入单个rune）

func HasPrefix

func HasPrefix(s, prefix []byte) bool

判断s是否有前缀切片prefix。

func HasSuffix

func HasSuffix(s, suffix []byte) bool

判断s是否有后缀切片suffix。

func Contains

func Contains(b, subslice []byte) bool

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

func Count

func Count(s, sep []byte) int

Count计算s中有多少个不重叠的sep子切片。

func Index

func Index(s, sep []byte) int

子切片sep在s中第一次出现的位置，不存在则返回-1。

func IndexByte

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

字符c在s中第一次出现的位置，不存在则返回-1。

func IndexRune

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

unicode字符r的utf-8编码在s中第一次出现的位置，不存在则返回-1。

func IndexAny

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

字符串chars中的任一utf-8编码在s中第一次出现的位置，如不存在或者chars为空字符串则返回-1

func IndexFunc

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

s中第一个满足函数f的位置i（该处的utf-8码值r满足f(r)==true），不存在则返回-1

func LastIndex

func LastIndex(s, sep []byte) int

切片sep在字符串s中最后一次出现的位置，不存在则返回-1。

func LastIndexAny

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

字符串chars中的任一utf-8字符在s中最后一次出现的位置，如不存在或者chars为空字符串则返回-1。

func LastIndexFunc

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

s中最后一个满足函数f的unicode码值的位置i，不存在则返回-1。

func Title

func Title(s []byte) []byte

返回s中每个单词的首字母都改为标题格式的拷贝。

BUG: Title用于划分单词的规则不能很好的处理Unicode标点符号。

func ToLower

func ToLower(s []byte) []byte

返回将所有字母都转为对应的小写版本的拷贝。

func ToLowerSpecial

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

使用_case规定的字符映射，返回将所有字母都转为对应的小写版本的拷贝。

func ToUpper

func ToUpper(s []byte) []byte

返回将所有字母都转为对应的大写版本的拷贝。

func ToUpperSpecial

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

使用_case规定的字符映射，返回将所有字母都转为对应的大写版本的拷贝。

func ToTitle

func ToTitle(s []byte) []byte

返回将所有字母都转为对应的标题版本的拷贝。

func ToTitleSpecial

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

使用_case规定的字符映射，返回将所有字母都转为对应的标题版本的拷贝。

func Repeat

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

返回count个b串联形成的新的切片。

func Replace

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

返回将s中前n个不重叠old切片序列都替换为new的新的切片拷贝，如果n<0会替换所有old子切片。

func Map

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

将s的每一个unicode码值r都替换为mapping(r)，返回这些新码值组成的切片拷贝。如果mapping返回一个负值，将会丢弃该码值而不会被替换（返回值中对应位置将没有码值）。

func Trim

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

返回将s前后端所有cutset包含的unicode码值都去掉的子切片。（共用底层数组）

func TrimSpace

func TrimSpace(s []byte) []byte

返回将s前后端所有空白（unicode.IsSpace指定）都去掉的子切片。（共用底层数组）

func TrimFunc

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

返回将s前后端所有满足f的unicode码值都去掉的子切片。（共用底层数组）

func TrimLeft

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

返回将s前端所有cutset包含的unicode码值都去掉的子切片。（共用底层数组）

func TrimLeftFunc

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

返回将s前端所有满足f的unicode码值都去掉的子切片。（共用底层数组）

func TrimPrefix

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

返回去除s可能的前缀prefix的子切片。（共用底层数组）

Example

func TrimRight

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

返回将s后端所有cutset包含的unicode码值都去掉的子切片。（共用底层数组）

func TrimRightFunc

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

返回将s后端所有满足f的unicode码值都去掉的子切片。（共用底层数组）

func TrimSuffix

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

返回去除s可能的后缀suffix的子切片。（共用底层数组）

func Fields

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

返回将字符串按照空白（unicode.IsSpace确定，可以是一到多个连续的空白字符）分割的多个子切片。如果字符串全部是空白或者是空字符串的话，会返回空切片。

func FieldsFunc

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

类似Fields，但使用函数f来确定分割符（满足f的utf-8码值）。如果字符串全部是分隔符或者是空字符串的话，会返回空切片。

func Split

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

用去掉s中出现的sep的方式进行分割，会分割到结尾，并返回生成的所有[]byte切片组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个[]byte切片。

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 : 返回所有的子字符串组成的切片

func SplitAfter

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

用从s中出现的sep后面切断的方式进行分割，会分割到结尾，并返回生成的所有[]byte切片组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个[]byte切片。

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 : 返回所有的子字符串组成的切片

func Join

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

将一系列[]byte切片连接为一个[]byte切片，之间用sep来分隔，返回生成的新切片。