copy.go

package sliceKit

import "github.com/richelieu-yang/chimera/v2/src/copyKit"

// CopyToDest 将src的元素复制到dest中（可能会修改dest的内容，但dest的内存地址不变！！！）
/*
PS:
(1) src和dest中只要有一个为nil（包括两个都为nil的情况），返回值必定为0 && 不会修改dest；
(2) src和dest都不为nil的情况下，len(src) <= len(dest)，复制 src的前n个元素 并用他们覆盖 dest的前n个元素（n == len(src)，可能为0）；
(3) src和dest都不为nil的情况下，len(src) > len(dest)，复制 src的前n个元素 并用他们覆盖 dest的前n个元素（n == len(dest)，可能为0）.

@param src	可以为nil
@param dest	可以为nil
@return 	被复制的元素的个数（即len(src)和len(dest)间的最小值；>= 0）

e.g. 	nil的情况
[byte](nil, nil) 				=> 0
[byte]([]byte("abc"), nil) 		=> 0
[byte](nil, []byte("abcde")) 	=> 0
e.g.1	正常情况
([]byte("012"), []byte("abcde")) => 3（dest变为[]byte("012de")）
([]byte("01234"), []byte("abc")) => 3（dest变为[]byte("012")）
*/
func CopyToDest[T any](src, dest []T) int {
	return copy(dest, src)
}

// Copy 浅拷贝（浅克隆）
/*
PS: 也可以使用 copyKit.Copy().
参考: golang复制切片的方法（避免操作同一底层数组） https://blog.csdn.net/weixin_43970884/article/details/126051345

@param src 可以为nil（此时将返回空的slice实例）
@return != nil

e.g.
	src := []string{"0", "1", "2"}
	dest := sliceKit.Copy(src)

	src[0] = "a"
	fmt.Println(src)  // [a 1 2]
	fmt.Println(dest) // [0 1 2]
*/
func Copy[T any](s []T) []T {
	dest := make([]T, len(s))
	copy(dest, s)
	return dest
}

// DeepCopy 深拷贝
func DeepCopy[T any](s []T) []T {
	return copyKit.DeepCopy(s)
}