Rename Values to Elements

Use the name "Element" as it is more intuitive.

Author: amikai

set.go

@@ -254,7 +254,9 @@ func NewThreadUnsafeSetFromMapKeys[T comparable, V any](val map[T]V) Set[T] {
 	return s
 }
 
-func Values[T comparable](s Set[T]) func(func(element T) bool) {
+// Elements returns an iterator that yields the elements of the set. Starting
+// with Go 1.23, users can use a for loop to iterate over it.
+func Elements[T comparable](s Set[T]) func(func(element T) bool) {
 	return func(yield func(element T) bool) {
 		s.Each(func(t T) bool {
 			return !yield(t)

set123_test.go

@@ -3,9 +3,11 @@
 
 package mapset
 
-import "testing"
+import (
+	"testing"
+)
 
-func TestAll123(t *testing.T) {
+func Test_Elements123(t *testing.T) {
 	a := NewSet[string]()
 
 	a.Add("Z")
@@ -14,7 +16,7 @@ func TestAll123(t *testing.T) {
 	a.Add("W")
 
 	b := NewSet[string]()
-	for elem := range Values(a) {
+	for elem := range Elements(a) {
 		b.Add(elem)
 	}
 
@@ -23,7 +25,7 @@ func TestAll123(t *testing.T) {
 	}
 
 	var count int
-	for range Values(a) {
+	for range Elements(a) {
 		if count == 2 {
 			break
 		}

set_test.go

@@ -1346,6 +1346,38 @@ func Test_NewThreadUnsafeSetFromMapKey_Strings(t *testing.T) {
 	}
 }
 
+func Test_Elements(t *testing.T) {
+	a := NewSet[string]()
+
+	a.Add("Z")
+	a.Add("Y")
+	a.Add("X")
+	a.Add("W")
+
+	b := NewSet[string]()
+	Elements(a)(func(elem string) bool {
+		b.Add(elem)
+		return true
+	})
+
+	if !a.Equal(b) {
+		t.Error("The sets are not equal after iterating (Each) through the first set")
+	}
+
+	var count int
+	Elements(a)(func(elem string) bool {
+		if count == 2 {
+			return false
+		}
+		count++
+		return true
+	})
+
+	if count != 2 {
+		t.Error("Iteration should stop on the way")
+	}
+}
+
 func Test_Example(t *testing.T) {
 	/*
 	   requiredClasses := NewSet()
@@ -1386,35 +1418,3 @@ func Test_Example(t *testing.T) {
 	   fmt.Println(allClasses.ContainsAll("Welding", "Automotive", "English"))
 	*/
 }
-
-func TestAll(t *testing.T) {
-	a := NewSet[string]()
-
-	a.Add("Z")
-	a.Add("Y")
-	a.Add("X")
-	a.Add("W")
-
-	b := NewSet[string]()
-	Values(a)(func(elem string) bool {
-		b.Add(elem)
-		return true
-	})
-
-	if !a.Equal(b) {
-		t.Error("The sets are not equal after iterating (Each) through the first set")
-	}
-
-	var count int
-	Values(a)(func(elem string) bool {
-		if count == 2 {
-			return false
-		}
-		count++
-		return true
-	})
-
-	if count != 2 {
-		t.Error("Iteration should stop on the way")
-	}
-}