Add Avg function to slice

slice.go

@@ -592,3 +592,16 @@ func IsSortedByKey[T any, K constraints.Ordered](collection []T, iteratee func(i
 
 	return true
 }
+
+// Avg returns the average value of given numbers
+// Play: https://go.dev/play/p/2sRbBlcYSHK
+func Avg(collection []int) int {
+	length := len(collection)
+	total := 0
+
+	for _, num := range collection {
+		total += num
+	}
+
+	return total / length
+}

slice_example_test.go

@@ -456,3 +456,13 @@ func ExampleIsSortedByKey() {
 
 	// Output: true
 }
+
+func ExampleAvg() {
+	numbers := []int{1, 2, 3, 4, 5}
+
+	result := Avg(numbers)
+
+	fmt.Printf("%v", result)
+
+	// Output: 3
+}

slice_test.go

@@ -388,7 +388,7 @@ func TestAssociate(t *testing.T) {
 
 func TestSliceToMap(t *testing.T) {
 	t.Parallel()
-	
+
 	type foo struct {
 		baz string
 		bar int
@@ -626,7 +626,7 @@ func TestSlice(t *testing.T) {
 	out16 := Slice(in, -10, 1)
 	out17 := Slice(in, -1, 3)
 	out18 := Slice(in, -10, 7)
-	
+
 	is.Equal([]int{}, out1)
 	is.Equal([]int{0}, out2)
 	is.Equal([]int{0, 1, 2, 3, 4}, out3)
@@ -759,3 +759,11 @@ func TestIsSortedByKey(t *testing.T) {
 		return ret
 	}))
 }
+
+func TestAvg(t *testing.T) {
+	t.Parallel()
+	is := assert.New(t)
+
+	is.Equal(Avg([]int{1, 2, 3, 4, 5}), 3)
+	is.Equal(Avg([]int{10, 20, 30, 40, 50}), 30)
+}