golang strings包的基本操作

golang 的字符串函数

strings包实现了用于操作字符的简单函数.
golang 的字符串常用内建函数如下：

关于type Reader 和 type Replacer操作文档链接：
https://studygolang.com/pkgdoc

EqualFold

func EqualFold(s, t string) bool
判断两个utf-8编码字符串（将unicode大写、小写、标题三种格式字符视为相同）是否相同。

	var name1 = "艾拉"
	var name2 = "艾拉"
	var name3 = "伊雷娜"
	fmt.Println(strings.EqualFold(name1, name2))	// ture
	fmt.Println(strings.EqualFold(name1, name3))	// false

HasPrefix

func HasPrefix(s, prefix string) bool
判断s是否有前缀字符串prefix。

	var name1 = "艾拉"
	var name2 = "伊"
	var name3 = "艾"
	fmt.Println(strings.HasPrefix(name1, name2))	// false
	fmt.Println(strings.HasPrefix(name1, name3))	// true

HasSuffix

func HasSuffix(s, suffix string) bool
判断s是否有后缀字符串suffix。

	var name1 = "艾拉"
	var name2 = "拉"
	var name3 = "艾"
	fmt.Println(strings.HasSuffix(name1, name2)) // true
	fmt.Println(strings.HasSuffix(name1, name3)) // false

Contains

func Contains(s, substr string) bool
判断字符串s是否包含子串substr。
Contains() 函数用于检查字符串 str 是否包含子字符串 substr。
它基于字节的比较，判断 str 中是否存在与 substr 相同的字节序列。
判断一个字符串中是否包含一个普通的ASCII字符比ContainsRune更为高效

	var string1 = "可塑性记忆"
	var string2 = "记忆"
	var string3 = "艾"
	fmt.Println(strings.Contains(string1, string2))	// true
	fmt.Println(strings.Contains(string1, string3))	// false

ContainsRune

func ContainsRune(s string, r rune) bool
判断字符串s是否包含utf-8码值r。

	var string1 = "可塑性记忆"
	var string2 = '记' // 单引号 ' 用于表示一个 Unicode 码点，而双引号 " 用于表示一个字符串
	var string3 = '艾'
	fmt.Println(string2, string3)                       // 35760 33406
	fmt.Println(strings.ContainsRune(string1, string2)) // true
	fmt.Println(strings.ContainsRune(string1, string3)) // false

ContainsAny

func ContainsAny(s, chars string) bool
判断字符串s是否包含字符串chars中的任一字符。

	var string1 = "可塑性记忆"
	var string2 = "qwq记"
	fmt.Println(strings.ContainsAny(string1, string2)) // true
	// 简单的说string2 只要有一个字符在string1里面就会返回true，一个都没有就会返回false

Count

func Count(s, sep string) int
返回字符串s中有几个不重复的sep子串。

	var string1 = "可塑性记忆,艾拉艾拉"
	var string2 = "艾拉"
	fmt.Println(strings.Count(string1, string2)) // 2

Index

func Index(s, sep string) int
子串sep在字符串s中第一次出现的位置，不存在则返回-1。

	var string1 = "可塑性记忆,艾拉艾拉"
	var string2 = "艾拉"

	//在 UTF-8 编码中 中文字符占用 3 个字节，而英文字符占用 1 个字节.   5*3 + 1
	fmt.Println(strings.Index(string1, string2)) // 16

	var string3 = "yanilo"
	var string4 = "l"
	fmt.Println(strings.Index(string3, string4)) // 4

IndexByte

func IndexByte(s string, c byte) int
字符c在s中第一次出现的位置，不存在则返回-1。
IndexByte 是一个函数，用于在字节切片中查找指定字节的索引位置

	byteSlice := []byte{10, 20, 30, 40, 50}
	index := bytes.IndexByte(byteSlice, 30)
	fmt.Println(index) // 输出：2

IndexRune

func IndexRune(s string, r rune) int
unicode码值r在s中第一次出现的位置，不存在则返回-1。
IndexRune 是一个函数，字符串中使用 strings.IndexRune 函数查找 Unicode 字符的索引位置时，返回的索引位置是以 Unicode 码点为单位的，而不是字节位置

	str := "ke可塑性记忆,艾拉艾拉"
	index := strings.IndexRune(str, '艾')
	fmt.Println(index) // 输出：18

IndexAny

func IndexAny(s, chars string) int
字符串chars中的任一utf-8码值在s中第一次出现的位置，如果不存在或者chars为空字符串则返回-1。

	str := "ke可塑性记忆,艾拉艾拉"
	charset := "艾塑"
	index := strings.IndexAny(str, charset)
	fmt.Println(index) // 输出：5

IndexFunc

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

	f := func(c rune) bool {
		return unicode.Is(unicode.Han, c)
	}
	fmt.Println(strings.IndexFunc("Hello, 世界", f))    // 输出：7
	fmt.Println(strings.IndexFunc("Hello, world", f))   // 输出：-1

LastIndex

func LastIndex(s, sep string) int
子串sep在字符串s中最后一次出现的位置，不存在则返回-1。

	str := "Hello, Hello, Hello"
	substr := "Hello"
	lastIndex := strings.LastIndex(str, substr)
	fmt.Println(lastIndex) // 输出：14

LastIndexAny

func LastIndexAny(s, chars string) int
字符串chars中的任一utf-8码值在s中最后一次出现的位置，如不存在或者chars为空字符串则返回-1。

	str := "Hello, World!"
	chars := "o!"
	lastIndex := strings.LastIndexAny(str, chars)
	fmt.Println(lastIndex) // 输出：12

LastIndexFunc

func LastIndexFunc(s string, f func(rune) bool) int
s中最后一个满足函数f的unicode码值的位置i，不存在则返回-1。

	str := "Hello, World!"
	// unicode.IsSpace 是一个函数，用于判断一个 Unicode 字符是否为空格字符。
	lastIndex := strings.LastIndexFunc(str, unicode.IsSpace)
	fmt.Println(lastIndex) // 输出：6

Title

func Title(s string) string
返回s中每个单词的首字母都改为标题格式的字符串拷贝。

	str := "hello, world!"
	titleString := strings.Title(str)
	fmt.Println(titleString) // 输出：Hello, World!

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

ToLower

func ToLower(s string) string
返回将所有字母都转为对应的小写版本的拷贝。

	str := "Hello, World!"
	lowerString := strings.ToLower(str)
	fmt.Println(lowerString) // 输出：hello, world!

ToLowerSpecial

func ToLowerSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的小写版本的拷贝。
ToLowerSpecial 是一个字符串处理函数，用于将字符串中的所有字符转换为小写形式，但可以指定特定的语言环境。

	str := "HÉLLÖ, WÖRLD!"
	locale := unicode.TurkishCase
	lowerString := strings.ToLowerSpecial(locale, str)
	fmt.Println(lowerString) // 输出：héllö, wörld!

ToUpper

func ToUpper(s string) string
返回将所有字母都转为对应的大写版本的拷贝。
ToUpper 是一个字符串处理函数，用于将字符串中的所有字符转换为大写形式。

	str := "Hello, World!"
	upperString := strings.ToUpper(str)
	fmt.Println(upperString) // 输出：HELLO, WORLD!

ToUpperSpecial

func ToUpperSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的大写版本的拷贝。
ToUpperSpecial 是一个字符串处理函数，用于将字符串中的所有字符转换为大写形式，但可以指定特定的语言环境。

	str := "héllö, wörld!"
	locale := unicode.TurkishCase
	upperString := strings.ToUpperSpecial(locale, str)
	fmt.Println(upperString) // 输出：HÉLLÖ, WÖRLD!

ToTitle

func ToTitle(s string) string
返回将所有字母都转为对应的标题版本的拷贝。

	str := "hello, world!"
	titleString := strings.ToTitle(str)
	fmt.Println(titleString) // 输出：HELLO, WORLD!

ToTitleSpecial

func ToTitleSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的标题版本的拷贝。
ToTitleSpecial 是一个字符串处理函数，用于将字符串中的所有字符转换为标题形式，但可以指定特定的语言环境。

	str := "héllö, wörld!"
	locale := unicode.TurkishCase
	titleString := strings.ToTitleSpecial(locale, str)
	fmt.Println(titleString) // 输出：HÉLLÖ, WÖRLD!

Repeat

func Repeat(s string, count int) string
返回count个s串联的字符串。
Repeat 是一个字符串处理函数，用于将指定的字符串重复多次以生成一个新的字符串。

	str := "hello"
	repeatedString := strings.Repeat(str, 3)
	fmt.Println(repeatedString) // 输出：hellohellohello

Replace

func Replace(s, old, new string, n int) string
返回将s中前n个不重叠old子串都替换为new的新字符串，如果n<0会替换所有old子串。
Replace 是一个字符串处理函数，用于将字符串中的指定子串替换为新的子串。

	str := "Hello, World!"
	newStr := strings.Replace(str, "World", "Golang", -1)
	fmt.Println(newStr) // 输出：Hello, Golang!

Map

func Map(mapping func(rune) rune, s string) string
将s的每一个unicode码值r都替换为mapping®，返回这些新码值组成的字符串拷贝。如果mapping返回一个负值，将会丢弃该码值而不会被替换。（返回值中对应位置将没有码值）
strings.Map 是 Go 语言中的一个字符串处理函数，用于对字符串中的每个字符执行指定的操作，并返回一个新的字符串。

	str := "Hello, World!"
	newStr := strings.Map(func(r rune) rune {
		if r == '!' {
			return '#'
		}
		return r
	}, str)
	fmt.Println(newStr) // 输出：Hello, World#

Trim

func Trim(s string, cutset string) string
返回将s前后端所有cutset包含的utf-8码值都去掉的字符串。
Trim 是一个常见的字符串处理操作，用于去除字符串的首尾指定字符或字符集合。

	str := "---   Hello, World!   ----"
	trimmedStr := strings.Trim(str, "-")
	fmt.Println(trimmedStr) // 输出：   Hello, World!

	trimmedStr2 := strings.Trim(trimmedStr, " ")
	fmt.Println(trimmedStr2) // 输出：Hello, World!

TrimSpace

func TrimSpace(s string) string
返回将s前后端所有空白（unicode.IsSpace指定）都去掉的字符串。
TrimSpace 是 Go 语言中的一个字符串处理函数，用于去除字符串首尾的空格符（包括空格、制表符和换行符）。

	str := "   Hello, World!   "
	trimmedStr := strings.TrimSpace(str)
	fmt.Println(trimmedStr) // 输出：Hello, World!

TrimFunc

func TrimFunc(s string, f func(rune) bool) string
返回将s前后端所有满足f的unicode码值都去掉的字符串。
TrimFunc 是 Go 语言中的一个字符串处理函数，用于根据自定义的函数逻辑来去除字符串的首尾字符。

	str := "   Hello, World!   "
	// unicode.IsSpace 是一个函数，用于判断一个 Unicode 字符是否为空格字符。
	trimmedStr := strings.TrimFunc(str, unicode.IsSpace)
	fmt.Println(trimmedStr) // 输出：Hello, World!

TrimLeft

func TrimLeft(s string, cutset string) string
返回将s前端所有cutset包含的utf-8码值都去掉的字符串。
TrimLeft 是 Go 语言中的一个字符串处理函数，用于去除字符串开头的指定字符。

	str := "!!!Hello, World!!!"
	trimmedStr := strings.TrimLeft(str, "!")
	fmt.Println(trimmedStr) // 输出：Hello, World!!!

func TrimLeftFunc
func TrimLeftFunc(s string, f func(rune) bool) string
返回将s前端所有满足f的unicode码值都去掉的字符串。
TrimLeftFunc 是 Go 语言中的一个字符串处理函数，用于根据自定义的函数逻辑来去除字符串开头的字符。

	str := "!!!Hello, World!!!"
	// unicode.IsPunct 是 Go 语言中的一个函数，用于判断给定的 Unicode 字符是否为标点符号。
	trimmedStr := strings.TrimLeftFunc(str, unicode.IsPunct)
	fmt.Println(trimmedStr) // 输出：Hello, World!!!

TrimPrefix

func TrimPrefix(s, prefix string) string
返回去除s可能的前缀prefix的字符串。
TrimPrefix 是 Go 语言中的一个字符串处理函数，用于去除字符串开头的指定前缀。

	str := "Hello, World!"
	trimmedStr := strings.TrimPrefix(str, "Hello, ")
	fmt.Println(trimmedStr) // 输出：World!

TrimRight

func TrimRight(s string, cutset string) string
返回将s后端所有cutset包含的utf-8码值都去掉的字符串。
TrimRight 是 Go 语言中的一个字符串处理函数，用于去除字符串末尾的指定字符集合。

	str := "Hello, World!!!"
	trimmedStr := strings.TrimRight(str, "!")
	fmt.Println(trimmedStr) // 输出：Hello, World

TrimRightFunc

func TrimRightFunc(s string, f func(rune) bool) string
返回将s后端所有满足f的unicode码值都去掉的字符串。
TrimRightFunc 是 Go 语言中的一个字符串处理函数，用于根据自定义的函数逻辑去除字符串末尾的字符。

	str := "Hello, World!!!"
	// unicode.IsPunct 是 Go 语言中的一个函数，用于判断给定的 Unicode 字符是否为标点符号。
	trimmedStr := strings.TrimRightFunc(str, unicode.IsPunct)
	fmt.Println(trimmedStr) // 输出：Hello, World
}

TrimSuffix

func TrimSuffix(s, suffix string) string
返回去除s可能的后缀suffix的字符串。
TrimSuffix 是 Go 语言中的一个字符串处理函数，用于去除字符串末尾的指定后缀。

	str := "Hello, World!!!"
	trimmedStr := strings.TrimSuffix(str, "!!!")
	fmt.Println(trimmedStr) // 输出：Hello, World

Fields

Fields(s string) []string

返回将字符串按照空白（unicode.IsSpace确定，可以是一到多个连续的空白字符）分割的多个字符串。如果字符串全部是空白或者是空字符串的话，会返回空切片。
strings.Fields 是 Go 语言中的一个字符串处理函数，用于将字符串按空白字符分割成多个子字符串，并返回一个子字符串的切片。

	str := "Hello   World\tGolang\nProgramming"
	fields := strings.Fields(str)
	fmt.Println(fields)		// [Hello World Golang Programming]

	for _, field := range fields {
		fmt.Println(field)
		//Hello
		//World
		//Golang
		//Programming
	}

FieldsFunc

func FieldsFunc(s string, f func(rune) bool) []string
类似Fields，但使用函数f来确定分割符（满足f的unicode码值）。如果字符串全部是分隔符或者是空字符串的话，会返回空切片。
FieldsFunc 是 Go 语言中的一个字符串处理函数，用于将字符串按照自定义的分隔函数进行分割，并返回一个子字符串的切片。

	str := "Hello, World! Golang Programming"
	// unicode.IsSpace 是 Go 语言中的一个函数，用于判断一个 Unicode 字符是否为空白字符。
	fields := strings.FieldsFunc(str, func(r rune) bool {
		return unicode.IsSpace(r) || r == '!'
	})
	fmt.Println(fields) // [Hello, World Golang Programming]

	for _, field := range fields {
		fmt.Println(field)
		// Hello,
		// World
		// Golang
		// Programming
	}

Split

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

	str := "Hello, World! Golang Programming"
	fields := strings.Split(str, ", ")
	fmt.Println(fields) // [Hello World! Golang Programming]

	for _, field := range fields {
		fmt.Println(field)
		// Hello
		// World! Golang Programming
	}

SplitN

func SplitN(s, sep string, n int) []string
用去掉s中出现的sep的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。参数n决定返回的切片的数目：
SplitN 是 Go 语言中的一个字符串处理函数，用于将字符串按照指定的分隔符进行分割，并返回一个子字符串的切片。与 Split 函数不同的是，SplitN 函数可以指定最大分割次数。
n > 0 : 返回的切片最多n个子字符串；最后一个子字符串包含未进行切割的部分。
n == 0: 返回nil
n < 0 : 返回所有的子字符串组成的切片

SplitN 是 Go 语言中的一个字符串处理函数，用于将字符串按照指定的分隔符进行分割，并返回一个子字符串的切片。与 Split 函数不同的是，SplitN 函数可以指定最大分割次数。

	str := "Hello, World! Golang Programming"
	fields := strings.SplitN(str, ", ", 2)

	fmt.Println(fields) // [Hello World! Golang Programming]
	for _, field := range fields {
		fmt.Println(field)
		// Hello
		// World! Golang Programming
	}

SplitAfter

func SplitAfter(s, sep string) []string
用从s中出现的sep后面切断的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。
SplitAfter 是 Go 语言中的一个字符串处理函数，用于将字符串按照指定的分隔符进行分割，并返回一个子字符串的切片。与 Split 函数不同的是，SplitAfter 函数在分割时会保留分隔符。

	str := "Hello, World! Golang Programming."
	fields := strings.SplitAfter(str, ", ")
	fmt.Println(fields) // [Hello,  World! Golang Programming.]

	for _, field := range fields {
		fmt.Println(field)
		// Hello,
		// World! Golang Programming.
	}

SplitAfterN

func SplitAfterN(s, sep string, n int) []string
用从s中出现的sep后面切断的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。参数n决定返回的切片的数目：

n > 0 : 返回的切片最多n个子字符串；最后一个子字符串包含未进行切割的部分。
n == 0: 返回nil
n < 0 : 返回所有的子字符串组成的切
Example
func Join
func Join(a []string, sep string) string
将一系列字符串连接为一个字符串，之间用sep来分隔。

SplitAfterN 是 Go 语言中的一个字符串处理函数，用于将字符串按照指定的分隔符进行分割，并返回一个子字符串的切片。与 SplitN 函数不同的是，SplitAfterN 函数在分割时会保留分隔符。

	str := "Hello, World! Golang Programming."
	fields := strings.SplitAfterN(str, ", ", 2)
	fmt.Println(fields) // [Hello,  World! Golang Programming.]

	for _, field := range fields {
		fmt.Println(field)
		// Hello,
		// World! Golang Programming.
	}

Reader

type Reader struct {
// 内含隐藏或非导出字段
}
Reader类型通过从一个字符串读取数据，实现了io.Reader、io.Seeker、io.ReaderAt、io.WriterTo、io.ByteScanner、io.RuneScanner接口。
Reader 是 Go 语言中的一个接口（interface），定义了读取操作的基本方法。Reader 接口可以用于从不同的数据源（如文件、网络连接、内存等）读取数据。

	reader := strings.NewReader("Hello, World!")

	buffer := make([]byte, 5)
	for {
		n, err := reader.Read(buffer)
		if err == io.EOF {
			break
		}
		/*
		io.EOF 是 Go 语言中的一个预定义错误变量，表示输入或输出操作已达到文件末尾（End of File）。
		EOF 是 "End of File" 的缩写。
		当读取操作（如从文件、网络连接或其他数据源读取数据）达到文件末尾时，读取函数通常会返回 io.EOF 错误，
		以指示已经读取完所有的数据。
		 */
		fmt.Printf("Read %d bytes: %s\n", n, buffer[:n])
		// Read 5 bytes: Hello
		// Read 5 bytes: , Wor
		// Read 3 bytes: ld!
	}

NewReader

func NewReader(s string) *Reader
NewReader创建一个从s读取数据的Reader。本函数类似bytes.NewBufferString，但是更有效率，且为只读的。

(*Reader) Len

func (r *Reader) Len() int
Len返回r包含的字符串还没有被读取的部分。

(*Reader) Read

func (r *Reader) Read(b []byte) (n int, err error)
func (*Reader) ReadByte
func (r *Reader) ReadByte() (b byte, err error)
func (*Reader) UnreadByte
func (r *Reader) UnreadByte() error
func (*Reader) ReadRune
func (r *Reader) ReadRune() (ch rune, size int, err error)
func (*Reader) UnreadRune
func (r *Reader) UnreadRune() error
func (*Reader) Seek
func (r *Reader) Seek(offset int64, whence int) (int64, error)
Seek实现了io.Seeker接口。

(*Reader) ReadAt

func (r *Reader) ReadAt(b []byte, off int64) (n int, err error)
func (*Reader) WriteTo
func (r *Reader) WriteTo(w io.Writer) (n int64, err error)
WriteTo实现了io.WriterTo接口。

Replacer

type Replacer struct {
// 内含隐藏或非导出字段
}
Replacer类型进行一系列字符串的替换。

NewReplacer

func NewReplacer(oldnew …string) Replacer
使用提供的多组old、new字符串对创建并返回一个Replacer。替换是依次进行的，匹配时不会重叠。

(*Replacer) Replace

func (r *Replacer) Replace(s string) string
Replace返回s的所有替换进行完后的拷贝。

(*Replacer) WriteString

func (r *Replacer) WriteString(w io.Writer, s string) (n int, err error)
WriteString向w中写入s的所有替换进行完后的拷贝。