Golang Replace String Examples: Replacer, NewReplacer

Use strings.Replace, in the strings package, to modify strings. Call NewReplacer.
Replace. Sometimes a string has characters we do not want. We can replace these substrings with other strings. In Go the strings package is helpful.
For simple replacements, we use strings.Replace. One or many occurrences can be targeted. For more complex sets of replacements we use a Replacer.
Example. This is a simple example. It uses the strings package and the strings.Replace method, which receives 4 arguments. The first argument is the string we are modifying.

And: The second 2 arguments are the "before" and "after" strings. The final argument is the occurrence count to replace.

Note: We pass -1 as the occurrence count, so all instances are replaced. To change 2 substrings, we could pass the value 2.

Golang program that uses strings.Replace method package main import ( "fmt" "strings" ) func main() { value := "Your cat is cute" fmt.Println(value) // Replace the "cat" with a "dog." result := strings.Replace(value, "cat", "dog", -1) fmt.Println(result) } Output Your cat is cute Your dog is cute
Count argument. We continue with a similar example of strings.Replace. The fourth argument here is positive 1. So only the first match is replaced—then the method stops.
Golang program that uses Replace, count argument package main import ( "fmt" "strings" ) func main() { value := "bird bird bird" // Use a positive number to indicate max replacement count. result := strings.Replace(value, "bird", "fish", 1) fmt.Println(result) } Output fish bird bird
Replacer. This is a class available in the strings package. We create a Replacer with the strings.NewReplace method. We pass string pairs to NewReplace.

Tip: The arguments to NewReplace are in the form of before and after strings, one after another, in pairs.

Replace: We invoke Replace() on the Replacer to apply all strings replacements. In this example, three strings are replaced.

Golang program that uses Replacer package main import ( "fmt" "strings" ) func main() { value := "bird, cat and fish" // Create replacer with pairs as arguments. r := strings.NewReplacer("bird", "dog", "cat", "lion", "fish", "monkey") // Replace all pairs. result := r.Replace(value) fmt.Println(result) } Output dog, lion and monkey
Replacer versus replace. Is Replacer faster than strings.Replace? In my benchmark, I found that there is a cost to creating a Replacer instance.

However: For repeated usage, a Replacer is faster than many calls to strings.Replace. But there is some complexity here.

Tip: If you have only a couple Replaces to do, creating a Replacer will end up costing more. For larger tasks, Replacer is superior.

Result: This program reuses a Replacer 1 million times. The Replacer is faster here than calling strings.Replace 3 million times.

Golang program that benchmarks Replacer, Replace method package main import ( "fmt" "strings" "time" ) func main() { original := "cat and dog" // Create Replacer (excluded from benchmark time). r := strings.NewReplacer("cat", "car", "and", "or", "dog", "truck") t0 := time.Now() // Version 1: use Replacer. for i := 0; i < 1000000; i++ { result := r.Replace(original) if result != "car or truck" { fmt.Println(0) } } t1 := time.Now() // Version 2: use Replace calls. for i := 0; i < 1000000; i++ { temp := strings.Replace(original, "cat", "car", -1) temp = strings.Replace(temp, "and", "or", -1) result := strings.Replace(temp, "dog", "truck", -1) if result != "car or truck" { fmt.Println(0) } } t2 := time.Now() // Results. fmt.Println(t1.Sub(t0)) fmt.Println(t2.Sub(t1)) } Output 624.437ms , Replacer 805.5738ms, strings.Replace
A summary. String replacements are important—they are a common task in programs. With strings.Replace we have a way to target one or more instances of substrings.
With Replacer, we have a powerful class that can combine many replacements. This will speed up large or complex sets of replacement.
© 2007-2019 Sam Allen. Every person is special and unique. Send bug reports to
Dot Net Perls