concurrency

type ConcurrentResult[T any] struct {
	// contains filtered or unexported fields
}

type HashMapNodeOption uint64

type Map[K comparable, V any] interface {
	// Get returns value by key
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	// then
	// m.Get(1) -> "test", true
	Get(key K) (V, bool)

	// Set sets value by key
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	// then
	// m.Get(1) -> "test", true
	Set(key K, value V)

	// Delete deletes value by key
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Delete(1)
	// then
	// m.Get(1) -> "", false
	Delete(key K)

	// Keys returns all keys in map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	// then
	// m.Keys() -> [1, 2]
	Keys() []K

	// Values returns all values in map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	// then
	// m.Values() -> ["test", "test2"]
	Values() []V

	// Range iterates all items in map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	//	m.Range(func(key int, value string) {
	//		fmt.Println(key, value)
	//	})
	// then
	// 1 test
	// 2 test2
	Range(f func(key K, value V))

	// Origin returns a copy of origin map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	//	o := m.Origin()
	// then
	//  o -> {1: "test", 2: "test2"}
	Origin() map[K]V

	// Length returns the length of map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	// then
	// m.Length() -> 2
	Length() int

	// Clear clears all items in map
	// example:
	//
	//	m := NewMap[int, string]()
	//	m.Set(1, "test")
	//	m.Set(2, "test2")
	//	m.Clear()
	// then
	// m.Length() -> 0
	Clear()
}

type Promise[T any] chan ConcurrentResult[T]

type Slice[T any] interface {
	// Append appends item to the end of slice
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Append(1)
	//	slice.Append(2)
	// then
	// slice.Items() -> [1, 2]
	Append(item T)

	// Appends appends items to the end of slice
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2)
	// then
	// slice.Items() -> [1, 2]
	Appends(items ...T)

	// SubSlice returns a new slice from start to end, means [start, end)
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	//	slice = slice.SubSlice(1, 3)
	// then
	// slice.Items() -> [2, 3]
	SubSlice(start, end int) Slice[T]

	// Items returns all items in slice
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	// then
	// slice.Items() -> [1, 2, 3, 4, 5]
	Items() []T

	// Get returns item by index
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	// then
	// slice.Get(0) -> 1
	Get(index int) T

	// Set sets item by index
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	//	slice.Set(0, 2)
	// then
	// slice.Items() -> [2, 2, 3, 4, 5]
	Set(index int, item T)

	// Length returns the length of slice
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	// then
	// slice.Length() -> 5
	Length() int

	// Capacity returns the capacity of slice
	// example:
	//
	//	slice := NewSlice[int]()
	//	slice.Appends(1, 2, 3, 4, 5)
	// then
	// slice.Capacity() -> 5
	Capacity() int
}