package strings

import "strings"

strings包实现了用于操作字符的简单函数。

Index

返回首页


  • func EqualFold(s, t string) bool
  • func HasPrefix(s, prefix string) bool
  • func HasSuffix(s, suffix string) bool
  • func Contains(s, substr string) bool
  • func ContainsRune(s string, r rune) bool
  • func ContainsAny(s, chars string) bool
  • func Count(s, sep string) int
  • func Index(s, sep string) int
  • func IndexByte(s string, c byte) int
  • func IndexRune(s string, r rune) int
  • func IndexAny(s, chars string) int
  • func IndexFunc(s string, f func(rune) bool) int
  • func LastIndex(s, sep string) int
  • func LastIndexAny(s, chars string) int
  • func LastIndexFunc(s string, f func(rune) bool) int
  • func Title(s string) string
  • func ToLower(s string) string
  • func ToLowerSpecial(_case unicode.SpecialCase, s string) string
  • func ToUpper(s string) string
  • func ToUpperSpecial(_case unicode.SpecialCase, s string) string
  • func ToTitle(s string) string
  • func ToTitleSpecial(_case unicode.SpecialCase, s string) string
  • func Repeat(s string, count int) string
  • func Replace(s, old, new string, n int) string
  • func Map(mapping func(rune) rune, s string) string
  • func Trim(s string, cutset string) string
  • func TrimSpace(s string) string
  • func TrimFunc(s string, f func(rune) bool) string
  • func TrimLeft(s string, cutset string) string
  • func TrimLeftFunc(s string, f func(rune) bool) string
  • func TrimPrefix(s, prefix string) string
  • func TrimRight(s string, cutset string) string
  • func TrimRightFunc(s string, f func(rune) bool) string
  • func TrimSuffix(s, suffix string) string
  • func Fields(s string) []string
  • func FieldsFunc(s string, f func(rune) bool) []string
  • func Split(s, sep string) []string
  • func SplitN(s, sep string, n int) []string
  • func SplitAfter(s, sep string) []string
  • func SplitAfterN(s, sep string, n int) []string
  • func Join(a []string, sep string) string
  • type Reader
  • type Replacer
  • Examples

    返回首页


  • Contains
  • ContainsAny
  • Count
  • EqualFold
  • Fields
  • FieldsFunc
  • Index
  • IndexAny
  • IndexFunc
  • IndexRune
  • Join
  • LastIndex
  • Map
  • NewReplacer
  • Repeat
  • Replace
  • Split
  • SplitAfter
  • SplitAfterN
  • SplitN
  • Title
  • ToLower
  • ToTitle
  • ToUpper
  • Trim
  • TrimPrefix
  • TrimSpace
  • TrimSuffix
  • func EqualFold

    func EqualFold(s, t string) bool

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

    Example
    fmt.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。

    Example
    fmt.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中的任一字符。

    Example
    fmt.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子串。

    Example
    fmt.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。

    Example
    fmt.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。

    Example
    fmt.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。

    Example
    fmt.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。

    Example
    f := 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。

    Example
    fmt.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标点符号。

    Example
    fmt.Println(strings.Title("her royal highness"))

    Output:

    Her Royal Highness
    

    func ToLower

    func ToLower(s string) string

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

    Example
    fmt.Println(strings.ToLower("Gopher"))

    Output:

    gopher
    

    func ToLowerSpecial

    func ToLowerSpecial(_case unicode.SpecialCase, s string) string

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

    func ToUpper

    func ToUpper(s string) string

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

    Example
    fmt.Println(strings.ToUpper("Gopher"))

    Output:

    GOPHER
    

    func ToUpperSpecial

    func ToUpperSpecial(_case unicode.SpecialCase, s string) string

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

    func ToTitle

    func ToTitle(s string) string

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

    Example
    fmt.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串联的字符串。

    Example
    fmt.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子串。

    Example
    fmt.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返回一个负值,将会丢弃该码值而不会被替换。(返回值中对应位置将没有码值)

    Example
    rot13 := 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码值都去掉的字符串。

    Example
    fmt.Printf("[%q]", strings.Trim(" !!! Achtung! Achtung! !!! ", "! "))

    Output:

    ["Achtung! Achtung"]
    

    func TrimSpace

    func TrimSpace(s string) string

    返回将s前后端所有空白(unicode.IsSpace指定)都去掉的字符串。

    Example
    fmt.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的字符串。

    Example
    var 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的字符串。

    Example
    var 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确定,可以是一到多个连续的空白字符)分割的多个字符串。如果字符串全部是空白或者是空字符串的话,会返回空切片。

    Example
    fmt.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码值)。如果字符串全部是分隔符或者是空字符串的话,会返回空切片。

    Example
    f := 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码值一个字符串。

    Example
    fmt.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码值一个字符串。

    Example
    fmt.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来分隔。

    Example
    s := []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。替换是依次进行的,匹配时不会重叠。

    Example
    r := strings.NewReplacer("<", "&lt;", ">", "&gt;")
    fmt.Println(r.Replace("This is <b>HTML</b>!"))

    Output:

    This is &lt;b&gt;HTML&lt;/b&gt;!
    

    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的所有替换进行完后的拷贝。