gstr
提供了强大便捷的文本处理组件,组件内置了大量常用的字符串处理方法,比较于 Golang
标准库更加全面丰富,可应对绝大部分业务场景。
使用方式:
import "github.com/gogf/gf/v2/text/gstr"
接口文档:
https://pkg.go.dev/github.com/gogf/gf/v2/text/gstr
以下常用方法列表,文档更新可能滞后于代码新特性,更多的方法及示例请参考代码文档: https://pkg.go.dev/github.com/gogf/gf/v2/text/gstr
字符串判断
IsNumeric
-
说明:
IsNumeric
验证字符串s
是否为数字。 -
格式:
IsNumeric(s string) bool
- 示例:
func ExampleIsNumeric() {
fmt.Println(gstr.IsNumeric("88"))
fmt.Println(gstr.IsNumeric("3.1415926"))
fmt.Println(gstr.IsNumeric("abc"))
// Output:
// true
// true
// false
}
字符串长度
LenRune
-
说明:
LenRune
返回unicode
字符串长度。 -
格式:
LenRune(str string) int
- 示例:
func ExampleLenRune() {
var (
str = `GoFrame框架`
result = gstr.LenRune(str)
)
fmt.Println(result)
// Output:
// 9
}
字符串创建
Repeat
-
说明:
Repeat
返回一个由input
重复multiplier
次后组成的新字符串。 -
格式:
Repeat(input string, multiplier int) string
- 示例:
func ExampleRepeat() {
var (
input = `goframe `
multiplier = 3
result = gstr.Repeat(input, multiplier)
)
fmt.Println(result)
// Output:
// goframe goframe goframe
}
大小写转换
ToLower
-
说明:
ToLower
将s
中所有Unicode
字符都变为小写并返回其副本。 -
格式:
ToLower(s string) string
- 示例:
func ExampleToLower() {
var (
s = `GOFRAME`
result = gstr.ToLower(s)
)
fmt.Println(result)
// Output:
// goframe
}
ToUpper
-
说明:
ToUpper
将s
中所有Unicode
字符都变为大写并返回其副本。 -
格式:
ToUpper(s string) string
- 示例:
func ExampleToUpper() {
var (
s = `goframe`
result = gstr.ToUpper(s)
)
fmt.Println(result)
// Output:
// GOFRAME
}
UcFirst
-
说明:
UcFirst
将s
中首字符变为大写并返回其副本。 -
格式:
UcFirst(s string) string
- 示例:
func ExampleUcFirst() {
var (
s = `hello`
result = gstr.UcFirst(s)
)
fmt.Println(result)
// Output:
// Hello
}
LcFirst
-
说明:
LcFirst
将s
中首字符变为小写并返回其副本。 -
格式:
LcFirst(s string) string
- 示例:
func ExampleLcFirst() {
var (
str = `Goframe`
result = gstr.LcFirst(str)
)
fmt.Println(result)
// Output:
// goframe
}
UcWords
-
说明:
UcWords
将字符串str
中每个单词的第一个字符变为大写。 -
格式:
UcWords(str string) string
- 示例:
func ExampleUcWords() {
var (
str = `hello world`
result = gstr.UcWords(str)
)
fmt.Println(result)
// Output:
// Hello World
}
IsLetterLower
-
说明:
IsLetterLower
验证给定的字符b
是否是小写字符。 -
格式:
IsLetterLower(b byte) bool
- 示例:
func ExampleIsLetterLower() {
fmt.Println(gstr.IsLetterLower('a'))
fmt.Println(gstr.IsLetterLower('A'))
// Output:
// true
// false
}
IsLetterUpper
-
说明:
IsLetterUpper
验证字符b
是否是大写字符。 -
格式:
IsLetterUpper(b byte) bool
- 示例:
func ExampleIsLetterUpper() {
fmt.Println(gstr.IsLetterUpper('A'))
fmt.Println(gstr.IsLetterUpper('a'))
// Output:
// true
// false
}
字符串比较
Compare
-
说明:
Compare
返回一个按字典顺序比较两个字符串的整数。 如果a == b
,结果为0
,如果a < b
,结果为-1
,如果a > b
,结果为+1
。 -
格式:
Compare(a, b string) int
- 示例:
func ExampleCompare() {
fmt.Println(gstr.Compare("c", "c"))
fmt.Println(gstr.Compare("a", "b"))
fmt.Println(gstr.Compare("c", "b"))
// Output:
// 0
// -1
// 1
}
Equal
-
说明:
Equal
返回a
和b
在不区分大小写的情况下是否相等。 -
格式:
Equal(a, b string) bool
- 示例:
func ExampleEqual() {
fmt.Println(gstr.Equal(`A`, `a`))
fmt.Println(gstr.Equal(`A`, `A`))
fmt.Println(gstr.Equal(`A`, `B`))
// Output:
// true
// true
// false
}
切分组合
Split
-
说明:
Split
用delimiter
将str
拆分为[]string
。 -
格式:
Split(str, delimiter string) []string
- 示例:
func ExampleSplit() {
var (
str = `a|b|c|d`
delimiter = `|`
result = gstr.Split(str, delimiter)
)
fmt.Printf(`%#v`, result)
// Output:
// []string{"a", "b", "c", "d"}
}
SplitAndTrim
-
说明:
SplitAndTrim
使用delimiter
将str
拆分为[]string
,并对[]string
的每个元素调用Trim
,并忽略在Trim
之后为空的元素。 -
格式:
SplitAndTrim(str, delimiter string, characterMask ...string) []string
- 示例:
func ExampleSplitAndTrim() {
var (
str = `a|b|||||c|d`
delimiter = `|`
result = gstr.SplitAndTrim(str, delimiter)
)
fmt.Printf(`%#v`, result)
// Output:
// []string{"a", "b", "c", "d"}
}
Join
-
说明:
Join
将array
中的每一个元素连接并生成一个新的字符串。参数sep
会作为新字符串的分隔符。 -
格式:
Join(array []string, sep string) string
- 示例:
func ExampleJoin() {
var (
array = []string{"goframe", "is", "very", "easy", "to", "use"}
sep = ` `
result = gstr.Join(array, sep)
)
fmt.Println(result)
// Output:
// goframe is very easy to use
}
JoinAny
-
说明:
JoinAny
将array
中的每一个元素连接并生成一个新的字符串。参数sep
会作为新字符串的分隔符。参数array
可以是任意的类型。 -
格式:
JoinAny(array interface{}, sep string) string
- 示例:
func ExampleJoinAny() {
var (
sep = `,`
arr2 = []int{99, 73, 85, 66}
result = gstr.JoinAny(arr2, sep)
)
fmt.Println(result)
// Output:
// 99,73,85,66
}
Explode
-
说明:
Explode
使用分隔符delimiter
字符串str
拆分成[]string
-
格式:
Explode(delimiter, str string) []string
- 示例:
func ExampleExplode() {
var (
str = `Hello World`
delimiter = " "
result = gstr.Explode(delimiter, str)
)
fmt.Printf(`%#v`, result)
// Output:
// []string{"Hello", "World"}
}
Implode
-
说明:
Implode
使用glue
连接pieces
字符串数组的每一个元素。 -
格式:
Implode(glue string, pieces []string) string
- 示例:
func ExampleImplode() {
var (
pieces = []string{"goframe", "is", "very", "easy", "to", "use"}
glue = " "
result = gstr.Implode(glue, pieces)
)
fmt.Println(result)
// Output:
// goframe is very easy to use
}
ChunkSplit
-
说明:
ChunkSplit
将字符串拆分为单位为chunkLen
长度更小的每一份,并用end
连接每一份拆分出的字符串。 -
格式:
ChunkSplit(body string, chunkLen int, end string) string
- 示例:
func ExampleChunkSplit() {
var (
body = `1234567890`
chunkLen = 2
end = "#"
result = gstr.ChunkSplit(body, chunkLen, end)
)
fmt.Println(result)
// Output:
// 12#34#56#78#90#
}
Fields
-
说明:
Fields
以[]string
的形式返回字符串中的每个单词。 -
格式:
Fields(str string) []string
- 示例:
func ExampleFields() {
var (
str = `Hello World`
result = gstr.Fields(str)
)
fmt.Printf(`%#v`, result)
// Output:
// []string{"Hello", "World"}
}
转义处理
AddSlashes
-
说明:
AddSlashes
将字符串中的符号前添加转义字符'\'
-
格式:
AddSlashes(str string) string
- 示例:
func ExampleAddSlashes() {
var (
str = `'aa'"bb"cc\r\n\d\t`
result = gstr.AddSlashes(str)
)
fmt.Println(result)
// Output:
// \'aa\'\"bb\"cc\\r\\n\\d\\t
}
StripSlashes
-
说明:
StripSlashes
去掉字符串str
中的转义字符'\'
。 -
格式:
StripSlashes(str string) string
- 示例:
func ExampleStripSlashes() {
var (
str = `C:\\windows\\GoFrame\\test`
result = gstr.StripSlashes(str)
)
fmt.Println(result)
// Output:
// C:\windows\GoFrame\test
}
QuoteMeta
-
说明:
QuoteMeta
为str中'. \ + * ? [ ^ ] ( $ )
中的每个字符前添加一个转义字符'\'。
-
格式:
QuoteMeta(str string, chars ...string) string