regexp: examples for Regexp.Expand and Regexp.ExpandString functions

Current documentation lacks simple examples for functions Regexp.Expand
and Regexp.ExpandString whose usage is unclear from description alone.
This commit adds examples that demonstrate usage in practical way.

Fixes #21649

Change-Id: I7b2c06c8ab747f69a6578f0595bf0f3c742ac479
Reviewed-on: https://go-review.googlesource.com/59470
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>

diff --git a/src/regexp/example_test.go b/src/regexp/example_test.go
index 2ac92d43820697c84b211d174109a5003bf91bda..0bf1f6bee76d0fc3c94aa3a3f38dae758d8de1e8 100644 (file)
--- a/src/regexp/example_test.go
+++ b/src/regexp/example_test.go
@@ -179,3 +179,67 @@ func ExampleRegexp_Split() {
        // [pizza]
        // [pi a]
 }
+
+func ExampleRegexp_Expand() {
+       content := []byte(`
+       # comment line
+       option1: value1
+       option2: value2
+
+       # another comment line
+       option3: value3
+`)
+
+       // Regex pattern captures "key: value" pair from the content.
+       pattern := regexp.MustCompile(`(?m)(?P<key>\w+):\s+(?P<value>\w+)$`)
+
+       // Template to convert "key: value" to "key=value" by
+       // referencing the values captured by the regex pattern.
+       template := []byte("$key=$value\n")
+
+       result := []byte{}
+
+       // For each match of the regex in the content.
+       for _, submatches := range pattern.FindAllSubmatchIndex(content, -1) {
+               // Apply the captured submatches to the template and append the output
+               // to the result.
+               result = pattern.Expand(result, template, content, submatches)
+       }
+       fmt.Println(string(result))
+       // Output:
+       // option1=value1
+       // option2=value2
+       // option3=value3
+}
+
+func ExampleRegexp_ExpandString() {
+       content := `
+       # comment line
+       option1: value1
+       option2: value2
+
+       # another comment line
+       option3: value3
+`
+
+       // Regex pattern captures "key: value" pair from the content.
+       pattern := regexp.MustCompile(`(?m)(?P<key>\w+):\s+(?P<value>\w+)$`)
+
+       // Template to convert "key: value" to "key=value" by
+       // referencing the values captured by the regex pattern.
+       template := "$key=$value\n"
+
+       result := []byte{}
+
+       // For each match of the regex in the content.
+       for _, submatches := range pattern.FindAllStringSubmatchIndex(content, -1) {
+               // Apply the captured submatches to the template and append the output
+               // to the result.
+               result = pattern.ExpandString(result, template, content, submatches)
+       }
+       fmt.Println(string(result))
+       // Output:
+       // option1=value1
+       // option2=value2
+       // option3=value3
+}