feat: added function Slice.Replace

example_test.go

@@ -158,6 +158,28 @@ func ExampleSlice_Insert() {
 	// [one two three four]
 }
 
+func ExampleSlice_Replace() {
+	s := slice.FromRaw([]string{"one", "two", "two", "two", "two"})
+	s.Replace(2, "three", "four", "five")
+	fmt.Println(s)
+
+	// Output:
+	// [one two three four five]
+}
+
+func ExampleSlice_Replace_false() {
+	s := slice.FromRaw([]string{"one", "two", "two", "two"})
+
+	// cannot replace 3 elements starting from index 2
+	// the given slice does not have enough elements
+	fmt.Println(s.Replace(2, "three", "four", "five"))
+	fmt.Println(s)
+
+	// Output:
+	// false
+	// [one two two two]
+}
+
 func ExampleSlice_Insert_false() {
 	s := slice.FromRaw[string](nil)
 	fmt.Println(s.Insert(1, "one")) // the highest possible index to insert == len(s)

slice.go

@@ -137,6 +137,22 @@ func (s *Slice[T]) Insert(index int, v ...T) (ok bool) {
 	return true
 }
 
+// Replace replaces s[index:index+len(v)] with v.
+// It does not succeed when the given slice does not have enough elements to be replaced.
+//
+//	s := slice.FromRaw([]string{"one", "two", "two", "two", "two"})
+//	s.Replace(2, "three", "four", "five")
+//	fmt.Println(s) // [one two three four five]
+func (s *Slice[T]) Replace(index int, v ...T) (ok bool) {
+	if index < 0 || index+len(v) > len(*s) {
+		return false
+	}
+
+	copy((*s)[index:index+len(v)], v)
+
+	return true
+}
+
 // Clone returns a new slice with the same length and copies to it all the elements from the existing slice.
 func (s *Slice[T]) Clone() Slice[T] {
 	if *s == nil {