strings
import "strings"
strings包实现了用于操作字符的简单函数。
- func NewReader(s string) *Reader
- func (r *Reader) Len() int
- func (r *Reader) Read(b []byte) (n int, err error)
- func (r *Reader) ReadByte() (b byte, err error)
- func (r *Reader) UnreadByte() error
- func (r *Reader) ReadRune() (ch rune, size int, err error)
- func (r *Reader) UnreadRune() error
- func (r *Reader) Seek(offset int64, whence int) (int64, error)
- func (r *Reader) ReadAt(b []byte, off int64) (n int, err error)
- func (r *Reader) WriteTo(w io.Writer) (n int64, err error)
- func NewReplacer(oldnew ...string) *Replacer
- func (r *Replacer) Replace(s string) string
- func (r *Replacer) WriteString(w io.Writer, s string) (n int, err error)
Examples
func EqualFold
func EqualFold(s, t string) bool
判断两个utf-8编码字符串（将unicode大写、小写、标题三种格式字符视为相同）是否相同。
Examplefmt.Println(strings.EqualFold("Go", "go"))
Output:
true
func HasPrefix
func HasPrefix(s, prefix string) bool
判断s是否有前缀字符串prefix。
func HasSuffix
func HasSuffix(s, suffix string) bool
判断s是否有后缀字符串suffix。
func Contains
func Contains(s, substr string) bool
判断字符串s是否包含子串substr。
Examplefmt.Println(strings.Contains("seafood", "foo"))
fmt.Println(strings.Contains("seafood", "bar"))
fmt.Println(strings.Contains("seafood", ""))
fmt.Println(strings.Contains("", ""))
Output:
true false true true
func ContainsRune
func ContainsRune(s string, r rune) bool
判断字符串s是否包含utf-8码值r。
func ContainsAny
func ContainsAny(s, chars string) bool
判断字符串s是否包含字符串chars中的任一字符。
Examplefmt.Println(strings.ContainsAny("team", "i"))
fmt.Println(strings.ContainsAny("failure", "u & i"))
fmt.Println(strings.ContainsAny("foo", ""))
fmt.Println(strings.ContainsAny("", ""))
Output:
false true false false
func Count
func Count(s, sep string) int
返回字符串s中有几个不重复的sep子串。
Examplefmt.Println(strings.Count("cheese", "e"))
fmt.Println(strings.Count("five", "")) // before & after each rune
Output:
3 5
func Index
func Index(s, sep string) int
子串sep在字符串s中第一次出现的位置，不存在则返回-1。
Examplefmt.Println(strings.Index("chicken", "ken"))
fmt.Println(strings.Index("chicken", "dmr"))
Output:
4 -1
func IndexByte
func IndexByte(s string, c byte) int
字符c在s中第一次出现的位置，不存在则返回-1。
func IndexRune
func IndexRune(s string, r rune) int
unicode码值r在s中第一次出现的位置，不存在则返回-1。
Examplefmt.Println(strings.IndexRune("chicken", 'k'))
fmt.Println(strings.IndexRune("chicken", 'd'))
Output:
4 -1
func IndexAny
func IndexAny(s, chars string) int
字符串chars中的任一utf-8码值在s中第一次出现的位置，如果不存在或者chars为空字符串则返回-1。
Examplefmt.Println(strings.IndexAny("chicken", "aeiouy"))
fmt.Println(strings.IndexAny("crwth", "aeiouy"))
Output:
2 -1
func IndexFunc
func IndexFunc(s string, f func(rune) bool) int
s中第一个满足函数f的位置i（该处的utf-8码值r满足f(r)==true），不存在则返回-1。
Examplef := func(c rune) bool {
return unicode.Is(unicode.Han, c)
}
fmt.Println(strings.IndexFunc("Hello, 世界", f))
fmt.Println(strings.IndexFunc("Hello, world", f))
Output:
7 -1
func LastIndex
func LastIndex(s, sep string) int
子串sep在字符串s中最后一次出现的位置，不存在则返回-1。
Examplefmt.Println(strings.Index("go gopher", "go"))
fmt.Println(strings.LastIndex("go gopher", "go"))
fmt.Println(strings.LastIndex("go gopher", "rodent"))
Output:
0 3 -1
func LastIndexAny
func LastIndexAny(s, chars string) int
字符串chars中的任一utf-8码值在s中最后一次出现的位置，如不存在或者chars为空字符串则返回-1。
func LastIndexFunc
func LastIndexFunc(s string, f func(rune) bool) int
s中最后一个满足函数f的unicode码值的位置i，不存在则返回-1。
func Title
func Title(s string) string
返回s中每个单词的首字母都改为标题格式的字符串拷贝。
BUG: Title用于划分单词的规则不能很好的处理Unicode标点符号。
Examplefmt.Println(strings.Title("her royal highness"))
Output:
Her Royal Highness
func ToLower
func ToLower(s string) string
返回将所有字母都转为对应的小写版本的拷贝。
Examplefmt.Println(strings.ToLower("Gopher"))
Output:
gopher
func ToLowerSpecial
func ToLowerSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的小写版本的拷贝。
func ToUpper
func ToUpper(s string) string
返回将所有字母都转为对应的大写版本的拷贝。
Examplefmt.Println(strings.ToUpper("Gopher"))
Output:
GOPHER
func ToUpperSpecial
func ToUpperSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的大写版本的拷贝。
func ToTitle
func ToTitle(s string) string
返回将所有字母都转为对应的标题版本的拷贝。
Examplefmt.Println(strings.ToTitle("loud noises"))
fmt.Println(strings.ToTitle("хлеб"))
Output:
LOUD NOISES ХЛЕБ
func ToTitleSpecial
func ToTitleSpecial(_case unicode.SpecialCase, s string) string
使用_case规定的字符映射，返回将所有字母都转为对应的标题版本的拷贝。
func Repeat
func Repeat(s string, count int) string
返回count个s串联的字符串。
Examplefmt.Println("ba" + strings.Repeat("na", 2))
Output:
banana
func Replace
func Replace(s, old, new string, n int) string
返回将s中前n个不重叠old子串都替换为new的新字符串，如果n<0会替换所有old子串。
Examplefmt.Println(strings.Replace("oink oink oink", "k", "ky", 2))
fmt.Println(strings.Replace("oink oink oink", "oink", "moo", -1))
Output:
oinky oinky oink moo moo moo
func Map
func Map(mapping func(rune) rune, s string) string
将s的每一个unicode码值r都替换为mapping(r)，返回这些新码值组成的字符串拷贝。如果mapping返回一个负值，将会丢弃该码值而不会被替换。（返回值中对应位置将没有码值）
Examplerot13 := func(r rune) rune {
switch {
case r >= 'A' && r <= 'Z':
return 'A' + (r-'A'+13)%26
case r >= 'a' && r <= 'z':
return 'a' + (r-'a'+13)%26
}
return r
}
fmt.Println(strings.Map(rot13, "'Twas brillig and the slithy gopher..."))
Output:
'Gjnf oevyyvt naq gur fyvgul tbcure...
func Trim
func Trim(s string, cutset string) string
返回将s前后端所有cutset包含的utf-8码值都去掉的字符串。
Examplefmt.Printf("[%q]", strings.Trim(" !!! Achtung! Achtung! !!! ", "! "))
Output:
["Achtung! Achtung"]
func TrimSpace
func TrimSpace(s string) string
返回将s前后端所有空白（unicode.IsSpace指定）都去掉的字符串。
Examplefmt.Println(strings.TrimSpace(" \t\n a lone gopher \n\t\r\n"))
Output:
a lone gopher
func TrimFunc
func TrimFunc(s string, f func(rune) bool) string
返回将s前后端所有满足f的unicode码值都去掉的字符串。
func TrimLeft
func TrimLeft(s string, cutset string) string
返回将s前端所有cutset包含的utf-8码值都去掉的字符串。
func TrimLeftFunc
func TrimLeftFunc(s string, f func(rune) bool) string
返回将s前端所有满足f的unicode码值都去掉的字符串。
func TrimPrefix
func TrimPrefix(s, prefix string) string
返回去除s可能的前缀prefix的字符串。
Examplevar s = "Goodbye,, world!"
s = strings.TrimPrefix(s, "Goodbye,")
s = strings.TrimPrefix(s, "Howdy,")
fmt.Print("Hello" + s)
Output:
Hello, world!
func TrimRight
func TrimRight(s string, cutset string) string
返回将s后端所有cutset包含的utf-8码值都去掉的字符串。
func TrimRightFunc
func TrimRightFunc(s string, f func(rune) bool) string
返回将s后端所有满足f的unicode码值都去掉的字符串。
func TrimSuffix
func TrimSuffix(s, suffix string) string
返回去除s可能的后缀suffix的字符串。
Examplevar s = "Hello, goodbye, etc!" s = strings.TrimSuffix(s, "goodbye, etc!") s = strings.TrimSuffix(s, "planet") fmt.Print(s, "world!")
Output:
Hello, world!
func Fields
func Fields(s string) []string
返回将字符串按照空白（unicode.IsSpace确定，可以是一到多个连续的空白字符）分割的多个字符串。如果字符串全部是空白或者是空字符串的话，会返回空切片。
Examplefmt.Printf("Fields are: %q", strings.Fields(" foo bar baz "))
Output:
Fields are: ["foo" "bar" "baz"]
func FieldsFunc
func FieldsFunc(s string, f func(rune) bool) []string
类似Fields，但使用函数f来确定分割符（满足f的unicode码值）。如果字符串全部是分隔符或者是空字符串的话，会返回空切片。
Examplef := func(c rune) bool {
return !unicode.IsLetter(c) && !unicode.IsNumber(c)
}
fmt.Printf("Fields are: %q", strings.FieldsFunc(" foo1;bar2,baz3...", f))
Output:
Fields are: ["foo1" "bar2" "baz3"]
func Split
func Split(s, sep string) []string
用去掉s中出现的sep的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。
Examplefmt.Printf("%q\n", strings.Split("a,b,c", ","))
fmt.Printf("%q\n", strings.Split("a man a plan a canal panama", "a "))
fmt.Printf("%q\n", strings.Split(" xyz ", ""))
fmt.Printf("%q\n", strings.Split("", "Bernardo O'Higgins"))
Output:
["a" "b" "c"] ["" "man " "plan " "canal panama"] [" " "x" "y" "z" " "] [""]
func SplitN
func SplitN(s, sep string, n int) []string
用去掉s中出现的sep的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。参数n决定返回的切片的数目：
n > 0 : 返回的切片最多n个子字符串；最后一个子字符串包含未进行切割的部分。 n == 0: 返回nil n < 0 : 返回所有的子字符串组成的切片Example
fmt.Printf("%q\n", strings.SplitN("a,b,c", ",", 2))
z := strings.SplitN("a,b,c", ",", 0)
fmt.Printf("%q (nil = %v)\n", z, z == nil)
Output:
["a" "b,c"] [] (nil = true)
func SplitAfter
func SplitAfter(s, sep string) []string
用从s中出现的sep后面切断的方式进行分割，会分割到结尾，并返回生成的所有片段组成的切片（每一个sep都会进行一次切割，即使两个sep相邻，也会进行两次切割）。如果sep为空字符，Split会将s切分成每一个unicode码值一个字符串。
Examplefmt.Printf("%q\n", strings.SplitAfter("a,b,c", ","))
Output:
["a," "b," "c"]
func 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
fmt.Printf("%q\n", strings.SplitAfterN("a,b,c", ",", 2))
Output:
["a," "b,c"]
func Join
func Join(a []string, sep string) string
将一系列字符串连接为一个字符串，之间用sep来分隔。
Examples := []string{"foo", "bar", "baz"}
fmt.Println(strings.Join(s, ", "))
Output:
foo, bar, baz
type Reader
type Reader struct {
// 内含隐藏或非导出字段
}
Reader类型通过从一个字符串读取数据，实现了io.Reader、io.Seeker、io.ReaderAt、io.WriterTo、io.ByteScanner、io.RuneScanner接口。
func NewReader
func NewReader(s string) *Reader
NewReader创建一个从s读取数据的Reader。本函数类似bytes.NewBufferString，但是更有效率，且为只读的。
func (*Reader) Len
func (r *Reader) Len() int
Len返回r包含的字符串还没有被读取的部分。
func (*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接口。
func (*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接口。
type Replacer
type Replacer struct {
// 内含隐藏或非导出字段
}
Replacer类型进行一系列字符串的替换。
func NewReplacer
func NewReplacer(oldnew ...string) *Replacer
使用提供的多组old、new字符串对创建并返回一个*Replacer。替换是依次进行的，匹配时不会重叠。
Exampler := strings.NewReplacer("<", "<", ">", ">")
fmt.Println(r.Replace("This is <b>HTML</b>!"))
Output:
This is <b>HTML</b>!
func (*Replacer) Replace
func (r *Replacer) Replace(s string) string
Replace返回s的所有替换进行完后的拷贝。
func (*Replacer) WriteString
func (r *Replacer) WriteString(w io.Writer, s string) (n int, err error)
WriteString向w中写入s的所有替换进行完后的拷贝。