aboutsummaryrefslogtreecommitdiff
path: root/src/strings/clone.go
diff options
context:
space:
mode:
Diffstat (limited to 'src/strings/clone.go')
-rw-r--r--src/strings/clone.go23
1 files changed, 23 insertions, 0 deletions
diff --git a/src/strings/clone.go b/src/strings/clone.go
new file mode 100644
index 0000000000..6097c6cc88
--- /dev/null
+++ b/src/strings/clone.go
@@ -0,0 +1,23 @@
+// Copyright 2021 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package strings
+
+import (
+ "unsafe"
+)
+
+// Clone returns a fresh copy of s.
+// It guarantees to make a copy of s into a new allocation,
+// which can be important when retaining only a small substring
+// of a much larger string. Using Clone can help such programs
+// use less memory. Of course, since using Clone makes a copy,
+// overuse of Clone can make programs use more memory.
+// Clone should typically be used only rarely, and only when
+// profiling indicates that it is needed.
+func Clone(s string) string {
+ b := make([]byte, len(s))
+ copy(b, s)
+ return *(*string)(unsafe.Pointer(&b))
+}