Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
gregex提供了对正则表达式的支持，底层是对标准库regexp的封装，极大地简化了正则的使用，并采用了解析缓存设计，提高了执行效率。
- 当函数名中有 All 的时候,它会继续查找非重叠的后续并返回 slice
- 当函数名中有 String 的时候,参数及返回值都是 String，否则为 byteSlice
使用方式：
import "github.com/gogf/gf/text/gregex"
接口文档：
https://godoc.org/github.com/gogf/gf/text/gregex
简单示例：
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
match, _ := gregex.MatchString(`(\w+).+\-\-\s*(.+)`, `GF is best! -- John`)
fmt.Printf(`%s says "%s" is the one he loves!`, match[2], match[1])
}
执行后，输出结果为：
John says "GF" is the one he loves!IsMatch / IsMatchString
说明： IsMatch()方法可以测试字符串，看它是否匹配正则表达式的模式。如果发现一次匹配，该方法返回"true"，否则返回"false"。
regexp已经在底层处理并缓存了Regex对象，无需每次显式重新创建，下同。
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
patternStr := `\d+`
g.Dump(gregex.IsMatch(patternStr, []byte("hello 2022! hello gf!")))
g.Dump(gregex.IsMatch(patternStr, nil))
g.Dump(gregex.IsMatch(patternStr, []byte("hello gf!")))
} |
执行后，输出结果为：
| Code Block |
|---|
true false false |
Match / MatchString
说明：用来匹配子字符串，Match只返回第一个匹配的结果。区别于原生的正则方法，gregex是对FindSubmatch进行封装，直接返回第一个包括子查询结果的 slice，下面这个例子是匹配 url 中的参数。| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
patternStr := `(\w+)=(\w+)`
matchStr := "https://goframe.org/pages/viewpage.action?pageId=1114219&searchId=8QC5D1D2E!"
// This method looks for the first match index
result, err := gregex.MatchString(patternStr, matchStr)
g.Dump(result)
g.Dump(err)
} |
执行后，输出结果为
| Code Block |
|---|
[ "pageId=1114219", "pageId", "1114219", ] <nil> |
MatchAll / MatchAllString
说明：用来匹配子字符串，MatchAll返回全部的结果。区别于原生的正则方法，gregex的 MatchAll 是对FindAllSubmatch方法进行封装，返回所有结果集的 slice，包括结果集中的子查询。下面这个例子是匹配 url 中的参数。
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
patternStr := `(\w+)=(\w+)`
matchStr := "https://goframe.org/pages/viewpage.action?pageId=1114219&searchId=8QC5D1D2E!"
result, err := gregex.MatchAllString(patternStr, matchStr)
g.Dump(result)
g.Dump(err)
} |
执行代码后输出
| Code Block |
|---|
[ [ "pageId=1114219", "pageId", "1114219", ], [ "searchId=8QC5D1D2E", "searchId", "8QC5D1D2E", ], ] <nil> |
Quote
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
result := gregex.Quote(`[1-9]\d+`)
g.Dump(result)
} |
执行后输出
| Code Block |
|---|
"\[1-9\]\\d\+" |
Replace / ReplaceString
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
var (
patternStr = `\d+`
str = "hello gf 2020!"
repStr = "2021"
result, err = gregex.Replace(patternStr, []byte(repStr), []byte(str))
)
g.Dump(err)
g.Dump(result)
} |
执行后输出
| Code Block |
|---|
<nil> "hello gf 2021!" |
ReplaceFunc / ReplaceStringFunc
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
replaceStrMap := map[string]string{
"2020": "2021",
}
// When the regular statement can match multiple results
// func can be used to further control the value that needs to be modified
result, err := gregex.ReplaceStringFunc(`\d+`, `hello gf 2018~2020!`, func(b string) string {
if replaceStr, ok := replaceStrMap[b]; ok {
return replaceStr
}
return b
})
g.Dump(result)
g.Dump(err)
result, err = gregex.ReplaceStringFunc(`[a-z]*`, "gf@goframe.org", strings.ToUpper)
g.Dump(result)
g.Dump(err)
} |
执行后输出
| Code Block |
|---|
"hello gf 2018~2021!" <nil> "GF@GOFRAME.ORG" <nil> |
ReplaceFuncMatch / ReplaceStringFuncMatch
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
var (
patternStr = `([A-Z])\w+`
str = "hello Golang 2018~2021!"
)
result, err := gregex.ReplaceStringFuncMatch(patternStr, str, func(match []string) string {
match[0] = "Gf"
return match[0]
})
g.Dump(result)
g.Dump(err)
} |
执行后输出
| Code Block |
|---|
"hello Gf 2018~2021!" <nil> |
Split
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
patternStr := `\d+`
str := "hello2020gf"
result := gregex.Split(patternStr, str)
g.Dump(result)
} |
执行后输出
| Code Block |
|---|
["hello","gf"] |
Validate
| Code Block |
|---|
package main
import (
"fmt"
"github.com/gogf/gf/text/gregex"
)
func main() {
// Valid match statement
g.Dump(gregex.Validate(`\d+`))
// Mismatched statement
g.Dump(gregex.Validate(`[a-9]\d+`))
} |
执行后输出
| Code Block |
|---|
<nil>
{
Code: "invalid character class range",
Expr: "a-9",
} |
| Panel | ||
|---|---|---|
| ||
|