diff --git a/text/gregex/gregex_z_example_test.go b/text/gregex/gregex_z_example_test.go
new file mode 100644
index 000000000..ecf6128d7
--- /dev/null
+++ b/text/gregex/gregex_z_example_test.go
@@ -0,0 +1,280 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+package gregex_test
+
+import (
+	"bytes"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/text/gregex"
+	"strings"
+)
+
+func ExampleIsMatch() {
+	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!")))
+
+	// Output:
+	// true
+	// false
+	// false
+}
+
+func ExampleIsMatchString() {
+	patternStr := `\d+`
+	g.Dump(gregex.IsMatchString(patternStr, "hello 2022! hello gf!"))
+	g.Dump(gregex.IsMatchString(patternStr, "hello gf!"))
+	g.Dump(gregex.IsMatchString(patternStr, ""))
+
+	// Output:
+	// true
+	// false
+	// false
+}
+
+func ExampleMatch() {
+	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.Match(patternStr, []byte(matchStr))
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	// [
+	//     "pageId=1114219",
+	//     "pageId",
+	//     "1114219",
+	// ]
+	// <nil>
+}
+
+func ExampleMatchString() {
+	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)
+
+	// Output:
+	// [
+	//     "pageId=1114219",
+	//     "pageId",
+	//     "1114219",
+	// ]
+	// <nil>
+}
+
+func ExampleMatchAll() {
+	patternStr := `(\w+)=(\w+)`
+	matchStr := "https://goframe.org/pages/viewpage.action?pageId=1114219&searchId=8QC5D1D2E!"
+	result, err := gregex.MatchAll(patternStr, []byte(matchStr))
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	//  [
+	//     [
+	//         "pageId=1114219",
+	//         "pageId",
+	//         "1114219",
+	//     ],
+	//     [
+	//         "searchId=8QC5D1D2E",
+	//         "searchId",
+	//         "8QC5D1D2E",
+	//     ],
+	// ]
+	// <nil>
+}
+
+func ExampleMatchAllString() {
+	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)
+
+	// Output:
+	// [
+	//     [
+	//         "pageId=1114219",
+	//         "pageId",
+	//         "1114219",
+	//     ],
+	//     [
+	//         "searchId=8QC5D1D2E",
+	//         "searchId",
+	//         "8QC5D1D2E",
+	//     ],
+	// ]
+	// <nil>
+}
+
+func ExampleQuote() {
+	result := gregex.Quote(`[1-9]\d+`)
+	g.Dump(result)
+
+	// Output:
+	// "\[1-9\]\\d\+"
+}
+
+func ExampleReplace() {
+	var (
+		patternStr  = `\d+`
+		str         = "hello gf 2020!"
+		repStr      = "2021"
+		result, err = gregex.Replace(patternStr, []byte(repStr), []byte(str))
+	)
+	g.Dump(err)
+	g.Dump(result)
+
+	// Output:
+	// <nil>
+	// "hello gf 2021!"
+}
+
+func ExampleReplaceFunc() {
+	// In contrast to [ExampleReplaceFunc]
+	// the result contains the `pattern' of all subpattern that use the matching function
+	result, err := gregex.ReplaceFuncMatch(`(\d+)~(\d+)`, []byte("hello gf 2018~2020!"), func(match [][]byte) []byte {
+		g.Dump(match)
+		match[2] = []byte("2021")
+		return bytes.Join(match[1:], []byte("~"))
+	})
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	// [
+	//     "2018~2020",
+	//     "2018",
+	//     "2020",
+	// ]
+	// "hello gf 2018~2021!"
+	// <nil>
+}
+
+func ExampleReplaceFuncMatch() {
+	var (
+		patternStr = `(\d+)~(\d+)`
+		str        = "hello gf 2018~2020!"
+	)
+	// In contrast to [ExampleReplaceFunc]
+	// the result contains the `pattern' of all subpatterns that use the matching function
+	result, err := gregex.ReplaceFuncMatch(patternStr, []byte(str), func(match [][]byte) []byte {
+		g.Dump(match)
+		match[2] = []byte("2021")
+		return bytes.Join(match[1:], []byte("-"))
+	})
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	// [
+	//     "2018~2020",
+	//     "2018",
+	//     "2020",
+	// ]
+	// "hello gf 2018-2021!"
+	// <nil>
+}
+
+func ExampleReplaceString() {
+	patternStr := `\d+`
+	str := "hello gf 2020!"
+	replaceStr := "2021"
+	result, err := gregex.ReplaceString(patternStr, replaceStr, str)
+
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	// "hello gf 2021!"
+	// <nil>
+}
+
+func ExampleReplaceStringFunc() {
+	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 {
+		g.Dump(b)
+		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)
+
+	// Output:
+	// "2018"
+	// "2020"
+	// "hello gf 2018~2021!"
+	// <nil>
+	// "GF@GOFRAME.ORG"
+	// <nil>
+}
+
+func ExampleReplaceStringFuncMatch() {
+	var (
+		patternStr = `([A-Z])\w+`
+		str        = "hello Golang 2018~2021!"
+	)
+	// In contrast to [ExampleReplaceFunc]
+	// the result contains the `pattern' of all subpatterns that use the matching function
+	result, err := gregex.ReplaceStringFuncMatch(patternStr, str, func(match []string) string {
+		g.Dump(match)
+		match[0] = "Gf"
+		return match[0]
+	})
+	g.Dump(result)
+	g.Dump(err)
+
+	// Output:
+	// [
+	//     "Golang",
+	//     "G",
+	// ]
+	// "hello Gf 2018~2021!"
+	// <nil>
+}
+
+func ExampleSplit() {
+	patternStr := `\d+`
+	str := "hello2020gf"
+	result := gregex.Split(patternStr, str)
+	g.Dump(result)
+
+	// Output:
+	// [
+	//     "hello",
+	//     "gf",
+	// ]
+}
+
+func ExampleValidate() {
+	// Valid match statement
+	g.Dump(gregex.Validate(`\d+`))
+	// Mismatched statement
+	g.Dump(gregex.Validate(`[a-9]\d+`))
+
+	// Output:
+	// <nil>
+	// {
+	//     Code: "invalid character class range",
+	//     Expr: "a-9",
+	// }
+}