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来分隔,返回生成的新切片。

上一篇:第十四章 红黑树——C++代码实现


下一篇:Go基础篇【第4篇】: 内置库模块 bufio