From e28be8d1149e194abbd214aadc570d6c16d7962c Mon Sep 17 00:00:00 2001
From: huangqian <huangqian1985@qq.com>
Date: Tue, 14 Dec 2021 23:54:15 +0800
Subject: [PATCH 1/2] reorder the sample function

---
 text/gstr/gstr_z_example_test.go | 1267 +++++++++++++++---------------
 1 file changed, 653 insertions(+), 614 deletions(-)

diff --git a/text/gstr/gstr_z_example_test.go b/text/gstr/gstr_z_example_test.go
index c21805713..465997ce4 100644
--- a/text/gstr/gstr_z_example_test.go
+++ b/text/gstr/gstr_z_example_test.go
@@ -12,139 +12,144 @@ import (
 	"github.com/gogf/gf/v2/text/gstr"
 )
 
-func ExampleAddSlashes() {
+func ExampleCount() {
 	var (
-		str    = `'aa'"bb"cc\r\n\d\t`
-		result = gstr.AddSlashes(str)
+		str     = `goframe is very, very easy to use`
+		substr1 = "goframe"
+		substr2 = "very"
+		result1 = gstr.Count(str, substr1)
+		result2 = gstr.Count(str, substr2)
 	)
+	fmt.Println(result1)
+	fmt.Println(result2)
 
+	// Output:
+	// 1
+	// 2
+}
+
+func ExampleCountI() {
+	var (
+		str     = `goframe is very, very easy to use`
+		substr1 = "GOFRAME"
+		substr2 = "VERY"
+		result1 = gstr.CountI(str, substr1)
+		result2 = gstr.CountI(str, substr2)
+	)
+	fmt.Println(result1)
+	fmt.Println(result2)
+
+	// Output:
+	// 1
+	// 2
+}
+
+func ExampleToLower() {
+	var (
+		s      = `GOFRAME`
+		result = gstr.ToLower(s)
+	)
 	fmt.Println(result)
 
 	// Output:
-	// \'aa\'\"bb\"cc\\r\\n\\d\\t
+	// goframe
 }
 
-func ExampleCaseCamel() {
+func ExampleToUpper() {
+	var (
+		s      = `goframe`
+		result = gstr.ToUpper(s)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// GOFRAME
+}
+
+func ExampleUcFirst() {
+	var (
+		s      = `hello`
+		result = gstr.UcFirst(s)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// Hello
+}
+
+func ExampleLcFirst() {
+	var (
+		str    = `Goframe`
+		result = gstr.LcFirst(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// goframe
+}
+
+func ExampleUcWords() {
 	var (
 		str    = `hello world`
-		result = gstr.CaseCamel(str)
+		result = gstr.UcWords(str)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// HelloWorld
+	// Hello World
 }
 
-func ExampleCaseCamelLower() {
+func ExampleIsLetterLower() {
+	fmt.Println(gstr.IsLetterLower('a'))
+	fmt.Println(gstr.IsLetterLower('A'))
+
+	// Output:
+	// true
+	// false
+}
+
+func ExampleIsLetterUpper() {
+	fmt.Println(gstr.IsLetterUpper('A'))
+	fmt.Println(gstr.IsLetterUpper('a'))
+
+	// Output:
+	// true
+	// false
+}
+
+func ExampleIsNumeric() {
+	fmt.Println(gstr.IsNumeric("88"))
+	fmt.Println(gstr.IsNumeric("3.1415926"))
+	fmt.Println(gstr.IsNumeric("abc"))
+	// Output:
+	// true
+	// true
+	// false
+}
+
+func ExampleReverse() {
 	var (
-		str    = `hello world`
-		result = gstr.CaseCamelLower(str)
+		str    = `123456`
+		result = gstr.Reverse(str)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// helloWorld
+	// 654321
 }
 
-func ExampleCaseDelimited() {
+func ExampleNumberFormat() {
 	var (
-		str    = `hello world`
-		del    = byte('-')
-		result = gstr.CaseDelimited(str, del)
+		number       float64 = 123456
+		decimals             = 2
+		decPoint             = "."
+		thousandsSep         = ","
+		result               = gstr.NumberFormat(number, decimals, decPoint, thousandsSep)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// hello-world
-}
-
-func ExampleCaseDelimitedScreaming() {
-	{
-		var (
-			str    = `hello world`
-			del    = byte('-')
-			result = gstr.CaseDelimitedScreaming(str, del, true)
-		)
-		fmt.Println(result)
-	}
-	{
-		var (
-			str    = `hello world`
-			del    = byte('-')
-			result = gstr.CaseDelimitedScreaming(str, del, false)
-		)
-		fmt.Println(result)
-	}
-
-	// Output:
-	// HELLO-WORLD
-	// hello-world
-}
-
-func ExampleCaseKebab() {
-	var (
-		str    = `hello world`
-		result = gstr.CaseKebab(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// hello-world
-}
-
-func ExampleCaseKebabScreaming() {
-	var (
-		str    = `hello world`
-		result = gstr.CaseKebabScreaming(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// HELLO-WORLD
-}
-
-func ExampleCaseSnake() {
-	var (
-		str    = `hello world`
-		result = gstr.CaseSnake(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// hello_world
-}
-
-func ExampleCaseSnakeFirstUpper() {
-	var (
-		str    = `RGBCodeMd5`
-		result = gstr.CaseSnakeFirstUpper(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// rgb_code_md5
-}
-
-func ExampleCaseSnakeScreaming() {
-	var (
-		str    = `hello world`
-		result = gstr.CaseSnakeScreaming(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// HELLO_WORLD
-}
-
-func ExampleChr() {
-	var (
-		ascii  = 65 // A
-		result = gstr.Chr(ascii)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// A
+	// 123,456.00
 }
 
 func ExampleChunkSplit() {
@@ -171,147 +176,6 @@ func ExampleCompare() {
 	// 1
 }
 
-func ExampleCompareVersion() {
-	fmt.Println(gstr.CompareVersion("v2.11.9", "v2.10.8"))
-	fmt.Println(gstr.CompareVersion("1.10.8", "1.19.7"))
-	fmt.Println(gstr.CompareVersion("2.8.beta", "2.8"))
-
-	// Output:
-	// 1
-	// -1
-	// 0
-}
-
-func ExampleCompareVersionGo() {
-	fmt.Println(gstr.CompareVersionGo("v2.11.9", "v2.10.8"))
-	fmt.Println(gstr.CompareVersionGo("v4.20.1", "v4.20.1+incompatible"))
-	fmt.Println(gstr.CompareVersionGo(
-		"v0.0.2-20180626092158-b2ccc119800e",
-		"v1.0.1-20190626092158-b2ccc519800e",
-	))
-
-	// Output:
-	// 1
-	// 1
-	// -1
-}
-
-func ExampleContains() {
-	{
-		var (
-			str    = `Hello World`
-			substr = `Hello`
-			result = gstr.Contains(str, substr)
-		)
-		fmt.Println(result)
-	}
-	{
-		var (
-			str    = `Hello World`
-			substr = `hello`
-			result = gstr.Contains(str, substr)
-		)
-		fmt.Println(result)
-	}
-
-	// Output:
-	// true
-	// false
-}
-
-func ExampleContainsAny() {
-	{
-		var (
-			s      = `goframe`
-			chars  = "g"
-			result = gstr.ContainsAny(s, chars)
-		)
-		fmt.Println(result)
-	}
-	{
-		var (
-			s      = `goframe`
-			chars  = "G"
-			result = gstr.ContainsAny(s, chars)
-		)
-		fmt.Println(result)
-	}
-
-	// Output:
-	// true
-	// false
-}
-
-func ExampleContainsI() {
-	var (
-		str     = `Hello World`
-		substr  = "hello"
-		result1 = gstr.Contains(str, substr)
-		result2 = gstr.ContainsI(str, substr)
-	)
-	fmt.Println(result1)
-	fmt.Println(result2)
-
-	// Output:
-	// false
-	// true
-}
-
-func ExampleCount() {
-	var (
-		str     = `goframe is very, very easy to use`
-		substr1 = "goframe"
-		substr2 = "very"
-		result1 = gstr.Count(str, substr1)
-		result2 = gstr.Count(str, substr2)
-	)
-	fmt.Println(result1)
-	fmt.Println(result2)
-
-	// Output:
-	// 1
-	// 2
-}
-
-func ExampleCountChars() {
-	var (
-		str    = `goframe`
-		result = gstr.CountChars(str)
-	)
-	fmt.Println(result)
-
-	// May Output:
-	// map[a:1 e:1 f:1 g:1 m:1 o:1 r:1]
-
-}
-
-func ExampleCountI() {
-	var (
-		str     = `goframe is very, very easy to use`
-		substr1 = "GOFRAME"
-		substr2 = "VERY"
-		result1 = gstr.CountI(str, substr1)
-		result2 = gstr.CountI(str, substr2)
-	)
-	fmt.Println(result1)
-	fmt.Println(result2)
-
-	// Output:
-	// 1
-	// 2
-}
-
-func ExampleCountWords() {
-	var (
-		str    = `goframe is very, very easy to use!`
-		result = gstr.CountWords(str)
-	)
-	fmt.Printf(`%#v`, result)
-
-	// Output:
-	// map[string]int{"easy":1, "goframe":1, "is":1, "to":1, "use!":1, "very":1, "very,":1}
-}
-
 func ExampleEqual() {
 	fmt.Println(gstr.Equal(`A`, `a`))
 	fmt.Println(gstr.Equal(`A`, `A`))
@@ -323,18 +187,6 @@ func ExampleEqual() {
 	// false
 }
 
-func ExampleExplode() {
-	var (
-		str       = `Hello World`
-		delimiter = " "
-		result    = gstr.Explode(delimiter, str)
-	)
-	fmt.Printf(`%#v`, result)
-
-	// Output:
-	// []string{"Hello", "World"}
-}
-
 func ExampleFields() {
 	var (
 		str    = `Hello World`
@@ -370,81 +222,115 @@ func ExampleHasSuffix() {
 	// true
 }
 
-func ExampleHideStr() {
+func ExampleCountWords() {
 	var (
-		str     = `13800138000`
-		percent = 40
-		hide    = `*`
-		result  = gstr.HideStr(str, percent, hide)
+		str    = `goframe is very, very easy to use!`
+		result = gstr.CountWords(str)
+	)
+	fmt.Printf(`%#v`, result)
+
+	// Output:
+	// map[string]int{"easy":1, "goframe":1, "is":1, "to":1, "use!":1, "very":1, "very,":1}
+}
+
+func ExampleCountChars() {
+	var (
+		str    = `goframe`
+		result = gstr.CountChars(str)
+	)
+	fmt.Println(result)
+
+	// May Output:
+	// map[a:1 e:1 f:1 g:1 m:1 o:1 r:1]
+}
+
+func ExampleWordWrap() {
+	{
+		var (
+			str    = `A very long woooooooooooooooooord. and something`
+			width  = 8
+			br     = "\n"
+			result = gstr.WordWrap(str, width, br)
+		)
+		fmt.Println(result)
+	}
+	{
+		var (
+			str    = `The quick brown fox jumped over the lazy dog.`
+			width  = 20
+			br     = "<br />\n"
+			result = gstr.WordWrap(str, width, br)
+		)
+		fmt.Printf("%v", result)
+	}
+
+	// Output:
+	// A very
+	// long
+	// woooooooooooooooooord.
+	// and
+	// something
+	// The quick brown fox<br />
+	// jumped over the lazy<br />
+	// dog.
+}
+
+func ExampleLenRune() {
+	var (
+		str    = `GoFrame框架`
+		result = gstr.LenRune(str)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// 138****8000
+	// 9
 }
 
-func ExampleImplode() {
+func ExampleRepeat() {
 	var (
-		pieces = []string{"goframe", "is", "very", "easy", "to", "use"}
-		glue   = " "
-		result = gstr.Implode(glue, pieces)
+		input      = `goframe `
+		multiplier = 3
+		result     = gstr.Repeat(input, multiplier)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// goframe is very easy to use
+	// goframe goframe goframe
 }
 
-func ExampleInArray() {
+func ExampleShuffle() {
 	var (
-		a      = []string{"goframe", "is", "very", "easy", "to", "use"}
-		s      = "goframe"
-		result = gstr.InArray(a, s)
+		str    = `123456`
+		result = gstr.Shuffle(str)
 	)
 	fmt.Println(result)
 
-	// Output:
-	// true
+	// May Output:
+	// 563214
 }
 
-func ExampleIsLetterLower() {
-	fmt.Println(gstr.IsLetterLower('a'))
-	fmt.Println(gstr.IsLetterLower('A'))
-
-	// Output:
-	// true
-	// false
-}
-
-func ExampleIsLetterUpper() {
-	fmt.Println(gstr.IsLetterUpper('A'))
-	fmt.Println(gstr.IsLetterUpper('a'))
-
-	// Output:
-	// true
-	// false
-}
-
-func ExampleIsNumeric() {
-	fmt.Println(gstr.IsNumeric("88"))
-	fmt.Println(gstr.IsNumeric("3.1415926"))
-	fmt.Println(gstr.IsNumeric("abc"))
-	// Output:
-	// true
-	// true
-	// false
-}
-
-func ExampleIsSubDomain() {
+func ExampleSplit() {
 	var (
-		subDomain  = `s.goframe.org`
-		mainDomain = `goframe.org`
-		result     = gstr.IsSubDomain(subDomain, mainDomain)
+		str       = `a|b|c|d`
+		delimiter = `|`
+		result    = gstr.Split(str, delimiter)
 	)
-	fmt.Println(result)
+	fmt.Printf(`%#v`, result)
 
 	// Output:
-	// true
+	// []string{"a", "b", "c", "d"}
+}
+
+func ExampleSplitAndTrim() {
+	var (
+		str       = `a|b|||||c|d`
+		delimiter = `|`
+		result    = gstr.SplitAndTrim(str, delimiter)
+	)
+	fmt.Printf(`%#v`, result)
+
+	// Output:
+	// []string{"a", "b", "c", "d"}
 }
 
 func ExampleJoin() {
@@ -471,41 +357,65 @@ func ExampleJoinAny() {
 	// 99,73,85,66
 }
 
-func ExampleLcFirst() {
+func ExampleExplode() {
 	var (
-		str    = `Goframe`
-		result = gstr.LcFirst(str)
+		str       = `Hello World`
+		delimiter = " "
+		result    = gstr.Explode(delimiter, str)
 	)
-	fmt.Println(result)
+	fmt.Printf(`%#v`, result)
 
 	// Output:
-	// goframe
+	// []string{"Hello", "World"}
 }
 
-func ExampleLenRune() {
+func ExampleImplode() {
 	var (
-		str    = `GoFrame框架`
-		result = gstr.LenRune(str)
+		pieces = []string{"goframe", "is", "very", "easy", "to", "use"}
+		glue   = " "
+		result = gstr.Implode(glue, pieces)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// 9
+	// goframe is very easy to use
 }
 
-func ExampleLevenshtein() {
+func ExampleChr() {
 	var (
-		str1    = "Hello World"
-		str2    = "hallo World"
-		costIns = 1
-		costRep = 1
-		costDel = 1
-		result  = gstr.Levenshtein(str1, str2, costIns, costRep, costDel)
+		ascii  = 65 // A
+		result = gstr.Chr(ascii)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// 2
+	// A
+}
+
+// '103' is the 'g' in ASCII
+func ExampleOrd() {
+	var (
+		str    = `goframe`
+		result = gstr.Ord(str)
+	)
+
+	fmt.Println(result)
+
+	// Output:
+	// 103
+}
+
+func ExampleHideStr() {
+	var (
+		str     = `13800138000`
+		percent = 40
+		hide    = `*`
+		result  = gstr.HideStr(str, percent, hide)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// 138****8000
 }
 
 func ExampleNl2Br() {
@@ -525,20 +435,257 @@ use`
 	// goframe<br>is<br>very<br>easy<br>to<br>use
 }
 
-func ExampleNumberFormat() {
+func ExampleAddSlashes() {
 	var (
-		number       float64 = 123456
-		decimals             = 2
-		decPoint             = "."
-		thousandsSep         = ","
-		result               = gstr.NumberFormat(number, decimals, decPoint, thousandsSep)
+		str    = `'aa'"bb"cc\r\n\d\t`
+		result = gstr.AddSlashes(str)
+	)
+
+	fmt.Println(result)
+
+	// Output:
+	// \'aa\'\"bb\"cc\\r\\n\\d\\t
+}
+
+func ExampleStripSlashes() {
+	var (
+		str    = `C:\\windows\\GoFrame\\test`
+		result = gstr.StripSlashes(str)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// 123,456.00
+	// C:\windows\GoFrame\test
 }
 
+func ExampleQuoteMeta() {
+	{
+		var (
+			str    = `.\+?[^]()`
+			result = gstr.QuoteMeta(str)
+		)
+		fmt.Println(result)
+	}
+	{
+		var (
+			str    = `https://goframe.org/pages/viewpage.action?pageId=1114327`
+			result = gstr.QuoteMeta(str)
+		)
+		fmt.Println(result)
+	}
+
+	// Output:
+	// \.\\\+\?\[\^\]\(\)
+	// https://goframe\.org/pages/viewpage\.action\?pageId=1114327
+
+}
+
+// array
+func ExampleSearchArray() {
+	var (
+		array  = []string{"goframe", "is", "very", "nice"}
+		str    = `goframe`
+		result = gstr.SearchArray(array, str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// 0
+}
+
+func ExampleInArray() {
+	var (
+		a      = []string{"goframe", "is", "very", "easy", "to", "use"}
+		s      = "goframe"
+		result = gstr.InArray(a, s)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// true
+}
+
+func ExamplePrefixArray() {
+	// Output:
+	// test
+}
+
+// case
+func ExampleCaseCamel() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseCamel(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// HelloWorld
+}
+
+func ExampleCaseCamelLower() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseCamelLower(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// helloWorld
+}
+
+func ExampleCaseSnake() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseSnake(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// hello_world
+}
+
+func ExampleCaseSnakeScreaming() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseSnakeScreaming(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// HELLO_WORLD
+}
+
+func ExampleCaseSnakeFirstUpper() {
+	var (
+		str    = `RGBCodeMd5`
+		result = gstr.CaseSnakeFirstUpper(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// rgb_code_md5
+}
+
+func ExampleCaseKebab() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseKebab(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// hello-world
+}
+
+func ExampleCaseKebabScreaming() {
+	var (
+		str    = `hello world`
+		result = gstr.CaseKebabScreaming(str)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// HELLO-WORLD
+}
+
+func ExampleCaseDelimited() {
+	var (
+		str    = `hello world`
+		del    = byte('-')
+		result = gstr.CaseDelimited(str, del)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// hello-world
+}
+
+func ExampleCaseDelimitedScreaming() {
+	{
+		var (
+			str    = `hello world`
+			del    = byte('-')
+			result = gstr.CaseDelimitedScreaming(str, del, true)
+		)
+		fmt.Println(result)
+	}
+	{
+		var (
+			str    = `hello world`
+			del    = byte('-')
+			result = gstr.CaseDelimitedScreaming(str, del, false)
+		)
+		fmt.Println(result)
+	}
+
+	// Output:
+	// HELLO-WORLD
+	// hello-world
+}
+
+// contain
+func ExampleContains() {
+	{
+		var (
+			str    = `Hello World`
+			substr = `Hello`
+			result = gstr.Contains(str, substr)
+		)
+		fmt.Println(result)
+	}
+	{
+		var (
+			str    = `Hello World`
+			substr = `hello`
+			result = gstr.Contains(str, substr)
+		)
+		fmt.Println(result)
+	}
+
+	// Output:
+	// true
+	// false
+}
+
+func ExampleContainsI() {
+	var (
+		str     = `Hello World`
+		substr  = "hello"
+		result1 = gstr.Contains(str, substr)
+		result2 = gstr.ContainsI(str, substr)
+	)
+	fmt.Println(result1)
+	fmt.Println(result2)
+
+	// Output:
+	// false
+	// true
+}
+
+func ExampleContainsAny() {
+	{
+		var (
+			s      = `goframe`
+			chars  = "g"
+			result = gstr.ContainsAny(s, chars)
+		)
+		fmt.Println(result)
+	}
+	{
+		var (
+			s      = `goframe`
+			chars  = "G"
+			result = gstr.ContainsAny(s, chars)
+		)
+		fmt.Println(result)
+	}
+
+	// Output:
+	// true
+	// false
+}
+
+// convert
 func ExampleOctStr() {
 	var (
 		str    = `\346\200\241`
@@ -550,19 +697,36 @@ func ExampleOctStr() {
 	// 怡
 }
 
-// '103' is the 'g' in ASCII
-func ExampleOrd() {
+// domain
+func ExampleIsSubDomain() {
 	var (
-		str    = `goframe`
-		result = gstr.Ord(str)
+		subDomain  = `s.goframe.org`
+		mainDomain = `goframe.org`
+		result     = gstr.IsSubDomain(subDomain, mainDomain)
 	)
-
 	fmt.Println(result)
 
 	// Output:
-	// 103
+	// true
 }
 
+// levenshtein
+func ExampleLevenshtein() {
+	var (
+		str1    = "Hello World"
+		str2    = "hallo World"
+		costIns = 1
+		costRep = 1
+		costDel = 1
+		result  = gstr.Levenshtein(str1, str2, costIns, costRep, costDel)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// 2
+}
+
+// parse
 func ExampleParse() {
 	{
 		var (
@@ -613,6 +777,7 @@ func ExampleParse() {
 	// map[a___[b:c]
 }
 
+// pos
 func ExamplePos() {
 	var (
 		haystack = `Hello World`
@@ -625,6 +790,21 @@ func ExamplePos() {
 	// 6
 }
 
+func ExamplePosRune() {
+	var (
+		haystack = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架`
+		needle   = `Go`
+		posI     = gstr.PosRune(haystack, needle)
+		posR     = gstr.PosRRune(haystack, needle)
+	)
+	fmt.Println(posI)
+	fmt.Println(posR)
+
+	// Output:
+	// 0
+	// 22
+}
+
 func ExamplePosI() {
 	var (
 		haystack = `goframe is very, very easy to use`
@@ -680,6 +860,21 @@ func ExamplePosR() {
 	// 17
 }
 
+func ExamplePosRRune() {
+	var (
+		haystack = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架`
+		needle   = `Go`
+		posI     = gstr.PosIRune(haystack, needle)
+		posR     = gstr.PosRRune(haystack, needle)
+	)
+	fmt.Println(posI)
+	fmt.Println(posR)
+
+	// Output:
+	// 0
+	// 22
+}
+
 func ExamplePosRI() {
 	var (
 		haystack = `goframe is very, very easy to use`
@@ -710,70 +905,7 @@ func ExamplePosRIRune() {
 	// 22
 }
 
-func ExamplePosRRune() {
-	var (
-		haystack = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架`
-		needle   = `Go`
-		posI     = gstr.PosIRune(haystack, needle)
-		posR     = gstr.PosRRune(haystack, needle)
-	)
-	fmt.Println(posI)
-	fmt.Println(posR)
-
-	// Output:
-	// 0
-	// 22
-}
-
-func ExamplePosRune() {
-	var (
-		haystack = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架`
-		needle   = `Go`
-		posI     = gstr.PosRune(haystack, needle)
-		posR     = gstr.PosRRune(haystack, needle)
-	)
-	fmt.Println(posI)
-	fmt.Println(posR)
-
-	// Output:
-	// 0
-	// 22
-}
-
-func ExampleQuoteMeta() {
-	{
-		var (
-			str    = `.\+?[^]()`
-			result = gstr.QuoteMeta(str)
-		)
-		fmt.Println(result)
-	}
-	{
-		var (
-			str    = `https://goframe.org/pages/viewpage.action?pageId=1114327`
-			result = gstr.QuoteMeta(str)
-		)
-		fmt.Println(result)
-	}
-
-	// Output:
-	// \.\\\+\?\[\^\]\(\)
-	// https://goframe\.org/pages/viewpage\.action\?pageId=1114327
-
-}
-
-func ExampleRepeat() {
-	var (
-		input      = `goframe `
-		multiplier = 3
-		result     = gstr.Repeat(input, multiplier)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// goframe goframe goframe
-}
-
+// replace
 func ExampleReplace() {
 	var (
 		origin  = `golang is very nice!`
@@ -787,6 +919,19 @@ func ExampleReplace() {
 	// goframe is very nice!
 }
 
+func ExampleReplaceI() {
+	var (
+		origin  = `golang is very nice!`
+		search  = `GOLANG`
+		replace = `goframe`
+		result  = gstr.ReplaceI(origin, search, replace)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// goframe is very nice!
+}
+
 func ExampleReplaceByArray() {
 	{
 		var (
@@ -810,6 +955,19 @@ func ExampleReplaceByArray() {
 	// goframe is very nice
 }
 
+func ExampleReplaceIByArray() {
+	var (
+		origin = `golang is very Good`
+		array  = []string{"Golang", "goframe", "GOOD", "nice"}
+		result = gstr.ReplaceIByArray(origin, array)
+	)
+
+	fmt.Println(result)
+
+	// Output:
+	// goframe is very nice
+}
+
 func ExampleReplaceByMap() {
 	{
 		var (
@@ -838,32 +996,6 @@ func ExampleReplaceByMap() {
 	// goframe is very nice
 }
 
-func ExampleReplaceI() {
-	var (
-		origin  = `golang is very nice!`
-		search  = `GOLANG`
-		replace = `goframe`
-		result  = gstr.ReplaceI(origin, search, replace)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// goframe is very nice!
-}
-
-func ExampleReplaceIByArray() {
-	var (
-		origin = `golang is very Good`
-		array  = []string{"Golang", "goframe", "GOOD", "nice"}
-		result = gstr.ReplaceIByArray(origin, array)
-	)
-
-	fmt.Println(result)
-
-	// Output:
-	// goframe is very nice
-}
-
 func ExampleReplaceIByMap() {
 	var (
 		origin   = `golang is very nice`
@@ -878,40 +1010,7 @@ func ExampleReplaceIByMap() {
 	// goframe is very nice
 }
 
-func ExampleReverse() {
-	var (
-		str    = `123456`
-		result = gstr.Reverse(str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// 654321
-}
-
-func ExampleSearchArray() {
-	var (
-		array  = []string{"goframe", "is", "very", "nice"}
-		str    = `goframe`
-		result = gstr.SearchArray(array, str)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// 0
-}
-
-func ExampleShuffle() {
-	var (
-		str    = `123456`
-		result = gstr.Shuffle(str)
-	)
-	fmt.Println(result)
-
-	// May Output:
-	// 563214
-}
-
+// similartext
 func ExampleSimilarText() {
 	var (
 		first   = `AaBbCcDd`
@@ -925,6 +1024,7 @@ func ExampleSimilarText() {
 	// 2
 }
 
+// soundex
 func ExampleSoundex() {
 	var (
 		str1    = `Hello`
@@ -938,30 +1038,7 @@ func ExampleSoundex() {
 	// H400 H400
 }
 
-func ExampleSplit() {
-	var (
-		str       = `a|b|c|d`
-		delimiter = `|`
-		result    = gstr.Split(str, delimiter)
-	)
-	fmt.Printf(`%#v`, result)
-
-	// Output:
-	// []string{"a", "b", "c", "d"}
-}
-
-func ExampleSplitAndTrim() {
-	var (
-		str       = `a|b|||||c|d`
-		delimiter = `|`
-		result    = gstr.SplitAndTrim(str, delimiter)
-	)
-	fmt.Printf(`%#v`, result)
-
-	// Output:
-	// []string{"a", "b", "c", "d"}
-}
-
+// str
 func ExampleStr() {
 	var (
 		haystack = `xxx.jpg`
@@ -986,6 +1063,57 @@ func ExampleStrEx() {
 	// a=1&b=2
 }
 
+func ExampleStrTill() {
+	var (
+		haystack = `https://goframe.org/index.html?test=123456`
+		needle   = `?`
+		result   = gstr.StrTill(haystack, needle)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// https://goframe.org/index.html?
+}
+
+func ExampleStrTillEx() {
+	var (
+		haystack = `https://goframe.org/index.html?test=123456`
+		needle   = `?`
+		result   = gstr.StrTillEx(haystack, needle)
+	)
+	fmt.Println(result)
+
+	// Output:
+	// https://goframe.org/index.html
+}
+
+// substr
+func ExampleSubStr() {
+	var (
+		str    = `1234567890`
+		start  = 0
+		length = 4
+		subStr = gstr.SubStr(str, start, length)
+	)
+	fmt.Println(subStr)
+
+	// Output:
+	// 1234
+}
+
+func ExampleSubStrRune() {
+	var (
+		str    = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架。`
+		start  = 14
+		length = 3
+		subStr = gstr.SubStrRune(str, start, length)
+	)
+	fmt.Println(subStr)
+
+	// Output:
+	// 高性能
+}
+
 func ExampleStrLimit() {
 	var (
 		str    = `123456789`
@@ -1012,89 +1140,27 @@ func ExampleStrLimitRune() {
 	// GoFrame是一款模块化、高性能...
 }
 
-func ExampleStrTill() {
-	var (
-		haystack = `https://goframe.org/index.html?test=123456`
-		needle   = `?`
-		result   = gstr.StrTill(haystack, needle)
-	)
-	fmt.Println(result)
-
+func ExampleSubStrFrom() {
 	// Output:
-	// https://goframe.org/index.html?
+	// test
 }
 
-func ExampleStrTillEx() {
-	var (
-		haystack = `https://goframe.org/index.html?test=123456`
-		needle   = `?`
-		result   = gstr.StrTillEx(haystack, needle)
-	)
-	fmt.Println(result)
-
+func ExampleSubStrFromEx() {
 	// Output:
-	// https://goframe.org/index.html
+	// test
 }
 
-func ExampleStripSlashes() {
-	var (
-		str    = `C:\\windows\\GoFrame\\test`
-		result = gstr.StripSlashes(str)
-	)
-	fmt.Println(result)
-
+func ExampleSubStrFromR() {
 	// Output:
-	// C:\windows\GoFrame\test
+	// test
 }
 
-func ExampleSubStr() {
-	var (
-		str    = `1234567890`
-		start  = 0
-		length = 4
-		subStr = gstr.SubStr(str, start, length)
-	)
-	fmt.Println(subStr)
-
+func ExampleSubStrFromREx() {
 	// Output:
-	// 1234
-}
-
-func ExampleSubStrRune() {
-	var (
-		str    = `GoFrame是一款模块化、高性能、企业级的Go基础开发框架。`
-		start  = 14
-		length = 3
-		subStr = gstr.SubStrRune(str, start, length)
-	)
-	fmt.Println(subStr)
-
-	// Output:
-	// 高性能
-}
-
-func ExampleToLower() {
-	var (
-		s      = `GOFRAME`
-		result = gstr.ToLower(s)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// goframe
-}
-
-func ExampleToUpper() {
-	var (
-		s      = `goframe`
-		result = gstr.ToUpper(s)
-	)
-	fmt.Println(result)
-
-	// Output:
-	// GOFRAME
+	// test
 }
 
+// trim
 func ExampleTrim() {
 	var (
 		str           = `*Hello World*`
@@ -1107,16 +1173,17 @@ func ExampleTrim() {
 	// Hello World
 }
 
-func ExampleTrimAll() {
+func ExampleTrimStr() {
 	var (
-		str           = `*Hello World*`
-		characterMask = "*"
-		result        = gstr.TrimAll(str, characterMask)
+		str    = `Hello World`
+		cut    = "World"
+		count  = -1
+		result = gstr.TrimStr(str, cut, count)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// HelloWorld
+	// Hello
 }
 
 func ExampleTrimLeft() {
@@ -1169,68 +1236,40 @@ func ExampleTrimRightStr() {
 	// Hello World
 }
 
-func ExampleTrimStr() {
+func ExampleTrimAll() {
 	var (
-		str    = `Hello World`
-		cut    = "World"
-		count  = -1
-		result = gstr.TrimStr(str, cut, count)
+		str           = `*Hello World*`
+		characterMask = "*"
+		result        = gstr.TrimAll(str, characterMask)
 	)
 	fmt.Println(result)
 
 	// Output:
-	// Hello
+	// HelloWorld
 }
 
-func ExampleUcFirst() {
-	var (
-		s      = `hello`
-		result = gstr.UcFirst(s)
-	)
-	fmt.Println(result)
+// version
+func ExampleCompareVersion() {
+	fmt.Println(gstr.CompareVersion("v2.11.9", "v2.10.8"))
+	fmt.Println(gstr.CompareVersion("1.10.8", "1.19.7"))
+	fmt.Println(gstr.CompareVersion("2.8.beta", "2.8"))
 
 	// Output:
-	// Hello
+	// 1
+	// -1
+	// 0
 }
 
-func ExampleUcWords() {
-	var (
-		str    = `hello world`
-		result = gstr.UcWords(str)
-	)
-	fmt.Println(result)
+func ExampleCompareVersionGo() {
+	fmt.Println(gstr.CompareVersionGo("v2.11.9", "v2.10.8"))
+	fmt.Println(gstr.CompareVersionGo("v4.20.1", "v4.20.1+incompatible"))
+	fmt.Println(gstr.CompareVersionGo(
+		"v0.0.2-20180626092158-b2ccc119800e",
+		"v1.0.1-20190626092158-b2ccc519800e",
+	))
 
 	// Output:
-	// Hello World
-}
-
-func ExampleWordWrap() {
-	{
-		var (
-			str    = `A very long woooooooooooooooooord. and something`
-			width  = 8
-			br     = "\n"
-			result = gstr.WordWrap(str, width, br)
-		)
-		fmt.Println(result)
-	}
-	{
-		var (
-			str    = `The quick brown fox jumped over the lazy dog.`
-			width  = 20
-			br     = "<br />\n"
-			result = gstr.WordWrap(str, width, br)
-		)
-		fmt.Printf("%v", result)
-	}
-
-	// Output:
-	// A very
-	// long
-	// woooooooooooooooooord.
-	// and
-	// something
-	// The quick brown fox<br />
-	// jumped over the lazy<br />
-	// dog.
+	// 1
+	// 1
+	// -1
 }

From ff2e9b568b14d3898cd8f7cbdc30be424807894d Mon Sep 17 00:00:00 2001
From: huangqian <huangqian1985@qq.com>
Date: Wed, 15 Dec 2021 21:15:34 +0800
Subject: [PATCH 2/2] Implemented gstr Example 1. PrefixArray 2.SubStrFrom
 3.SubStrFromEx 4.SubStrFromR 5.SubStrFromREx

---
 text/gstr/gstr_z_example_test.go | 46 ++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 5 deletions(-)

diff --git a/text/gstr/gstr_z_example_test.go b/text/gstr/gstr_z_example_test.go
index 465997ce4..c3499dda5 100644
--- a/text/gstr/gstr_z_example_test.go
+++ b/text/gstr/gstr_z_example_test.go
@@ -506,8 +506,16 @@ func ExampleInArray() {
 }
 
 func ExamplePrefixArray() {
+	var (
+		strArray = []string{"tom", "lily", "john"}
+	)
+
+	gstr.PrefixArray(strArray, "classA_")
+
+	fmt.Println(strArray)
+
 	// Output:
-	// test
+	// [classA_tom classA_lily classA_john]
 }
 
 // case
@@ -1141,23 +1149,51 @@ func ExampleStrLimitRune() {
 }
 
 func ExampleSubStrFrom() {
+	var (
+		str  = "我爱GoFrameGood"
+		need = `爱`
+	)
+
+	fmt.Println(gstr.SubStrFrom(str, need))
+
 	// Output:
-	// test
+	// 爱GoFrameGood
 }
 
 func ExampleSubStrFromEx() {
+	var (
+		str  = "我爱GoFrameGood"
+		need = `爱`
+	)
+
+	fmt.Println(gstr.SubStrFromEx(str, need))
+
 	// Output:
-	// test
+	// GoFrameGood
 }
 
 func ExampleSubStrFromR() {
+	var (
+		str  = "我爱GoFrameGood"
+		need = `Go`
+	)
+
+	fmt.Println(gstr.SubStrFromR(str, need))
+
 	// Output:
-	// test
+	// Good
 }
 
 func ExampleSubStrFromREx() {
+	var (
+		str  = "我爱GoFrameGood"
+		need = `Go`
+	)
+
+	fmt.Println(gstr.SubStrFromREx(str, need))
+
 	// Output:
-	// test
+	// od
 }
 
 // trim