Documentation
¶
Overview ¶
mapsパッケージは、任意の型のマップに役立つさまざまな関数を定義します。
このパッケージは、浮動小数点数のNaNのような非反射キー (k != kとなるキー)に対する特別な処理を行いません。
Index ¶
- func All[Map ~map[K]V, K comparable, V any](m Map) iter.Seq2[K, V]
- func Clone[M ~map[K]V, K comparable, V any](m M) M
- func Collect[K comparable, V any](seq iter.Seq2[K, V]) map[K]V
- func Copy[M1 ~map[K]V, M2 ~map[K]V, K comparable, V any](dst M1, src M2)
- func DeleteFunc[M ~map[K]V, K comparable, V any](m M, del func(K, V) bool)
- func Equal[M1, M2 ~map[K]V, K, V comparable](m1 M1, m2 M2) bool
- func EqualFunc[M1 ~map[K]V1, M2 ~map[K]V2, K comparable, V1, V2 any](m1 M1, m2 M2, eq func(V1, V2) bool) bool
- func Insert[Map ~map[K]V, K comparable, V any](m Map, seq iter.Seq2[K, V])
- func Keys[Map ~map[K]V, K comparable, V any](m Map) iter.Seq[K]
- func Values[Map ~map[K]V, K comparable, V any](m Map) iter.Seq[V]
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func All ¶ added in v1.23.0
func All[Map ~map[K]V, K comparable, V any](m Map) iter.Seq2[K, V]
Allは、mからキーと値のペアを反復するイテレータを返します。 イテレーションの順序は指定されておらず、呼び出しごとに同じであることは保証されません。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
)
func main() {
m1 := map[string]int{
"one": 1,
"two": 2,
}
m2 := map[string]int{
"one": 10,
}
maps.Insert(m2, maps.All(m1))
fmt.Println("m2 is:", m2)
}
Output: m2 is: map[one:1 two:2]
func Clone ¶
func Clone[M ~map[K]V, K comparable, V any](m M) M
Cloneは、mのコピーを返します。これは浅いクローンです。 新しいキーと値は、通常の代入を使用して設定されます。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
)
func main() {
m1 := map[string]int{
"key": 1,
}
m2 := maps.Clone(m1)
m2["key"] = 100
fmt.Println(m1["key"])
fmt.Println(m2["key"])
m3 := map[string][]int{
"key": {1, 2, 3},
}
m4 := maps.Clone(m3)
fmt.Println(m4["key"][0])
m4["key"][0] = 100
fmt.Println(m3["key"][0])
fmt.Println(m4["key"][0])
}
Output: 1 100 1 100 100
func Collect ¶ added in v1.23.0
func Collect[K comparable, V any](seq iter.Seq2[K, V]) map[K]V
Collectは、seqからキーと値のペアを収集して新しいマップに格納し、 それを返します。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
"github.com/shogo82148/std/slices"
)
func main() {
s1 := []string{"zero", "one", "two", "three"}
m1 := maps.Collect(slices.All(s1))
fmt.Println("m1 is:", m1)
}
Output: m1 is: map[0:zero 1:one 2:two 3:three]
func Copy ¶
func Copy[M1 ~map[K]V, M2 ~map[K]V, K comparable, V any](dst M1, src M2)
Copyは、srcのすべてのキー/値ペアをコピーし、それらをdstに追加します。 srcのキーがdstにすでに存在する場合、 dstの値はsrcのキーに関連付けられた値によって上書きされます。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
)
func main() {
m1 := map[string]int{
"one": 1,
"two": 2,
}
m2 := map[string]int{
"one": 10,
}
maps.Copy(m2, m1)
fmt.Println("m2 is:", m2)
m2["one"] = 100
fmt.Println("m1 is:", m1)
fmt.Println("m2 is:", m2)
m3 := map[string][]int{
"one": {1, 2, 3},
"two": {4, 5, 6},
}
m4 := map[string][]int{
"one": {7, 8, 9},
}
maps.Copy(m4, m3)
fmt.Println("m4 is:", m4)
m4["one"][0] = 100
fmt.Println("m3 is:", m3)
fmt.Println("m4 is:", m4)
}
Output: m2 is: map[one:1 two:2] m1 is: map[one:1 two:2] m2 is: map[one:100 two:2] m4 is: map[one:[1 2 3] two:[4 5 6]] m3 is: map[one:[100 2 3] two:[4 5 6]] m4 is: map[one:[100 2 3] two:[4 5 6]]
func DeleteFunc ¶
func DeleteFunc[M ~map[K]V, K comparable, V any](m M, del func(K, V) bool)
DeleteFuncは、delがtrueを返す場合、mから任意のキー/値ペアを削除します。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
)
func main() {
m := map[string]int{
"one": 1,
"two": 2,
"three": 3,
"four": 4,
}
maps.DeleteFunc(m, func(k string, v int) bool {
return v%2 != 0 // delete odd values
})
fmt.Println(m)
}
Output: map[four:4 two:2]
func Equal ¶
func Equal[M1, M2 ~map[K]V, K, V comparable](m1 M1, m2 M2) bool
Equalは、2つのマップが同じキー/値のペアを含むかどうかを報告します。 値は==を使用して比較されます。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
)
func main() {
m1 := map[int]string{
1: "one",
10: "Ten",
1000: "THOUSAND",
}
m2 := map[int]string{
1: "one",
10: "Ten",
1000: "THOUSAND",
}
m3 := map[int]string{
1: "one",
10: "ten",
1000: "thousand",
}
fmt.Println(maps.Equal(m1, m2))
fmt.Println(maps.Equal(m1, m3))
}
Output: true false
func EqualFunc ¶
func EqualFunc[M1 ~map[K]V1, M2 ~map[K]V2, K comparable, V1, V2 any](m1 M1, m2 M2, eq func(V1, V2) bool) bool
EqualFuncはEqualと同様ですが、eqを使用して値を比較します。 キーは引き続き==で比較されます。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
"github.com/shogo82148/std/strings"
)
func main() {
m1 := map[int]string{
1: "one",
10: "Ten",
1000: "THOUSAND",
}
m2 := map[int][]byte{
1: []byte("One"),
10: []byte("Ten"),
1000: []byte("Thousand"),
}
eq := maps.EqualFunc(m1, m2, func(v1 string, v2 []byte) bool {
return strings.EqualFold(v1, string(v2))
})
fmt.Println(eq)
}
Output: true
func Insert ¶ added in v1.23.0
func Insert[Map ~map[K]V, K comparable, V any](m Map, seq iter.Seq2[K, V])
Insertは、seqからmにキーと値のペアを追加します。 seq内のキーがすでにmに存在する場合、その値は上書きされます。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
"github.com/shogo82148/std/slices"
)
func main() {
m1 := map[int]string{
1000: "THOUSAND",
}
s1 := []string{"zero", "one", "two", "three"}
maps.Insert(m1, slices.All(s1))
fmt.Println("m1 is:", m1)
}
Output: m1 is: map[0:zero 1:one 2:two 3:three 1000:THOUSAND]
func Keys ¶ added in v1.23.0
func Keys[Map ~map[K]V, K comparable, V any](m Map) iter.Seq[K]
Keysは、m内のキーを反復するイテレータを返します。 イテレーションの順序は指定されておらず、呼び出しごとに同じであることは保証されません。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
"github.com/shogo82148/std/slices"
)
func main() {
m1 := map[int]string{
1: "one",
10: "Ten",
1000: "THOUSAND",
}
keys := slices.Sorted(maps.Keys(m1))
fmt.Println(keys)
}
Output: [1 10 1000]
func Values ¶ added in v1.23.0
func Values[Map ~map[K]V, K comparable, V any](m Map) iter.Seq[V]
Valuesは、m内の値を反復するイテレータを返します。 イテレーションの順序は指定されておらず、呼び出しごとに同じであることは保証されません。
Example ¶
package main
import (
"github.com/shogo82148/std/fmt"
"github.com/shogo82148/std/maps"
"github.com/shogo82148/std/slices"
)
func main() {
m1 := map[int]string{
1: "one",
10: "Ten",
1000: "THOUSAND",
}
values := slices.Sorted(maps.Values(m1))
fmt.Println(values)
}
Output: [THOUSAND Ten one]
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.