Merge pull request #884 from devlights/add-iter-slices-all

Author: devlights

examples/basic/slices/README.md

@@ -22,3 +22,4 @@
 | slice_convert_to_array_go117.go  | slice_convert_to_array_go117  | Go 1.17 以降で有効な スライス から 配列 への変換方法についてのサンプルです |
 | slice_append_special_behavior.go | slice_append_special_behavior | append() を利用する際の特別な挙動に付いてのサンプルです                    |
 | slice_iter_values.go             | slice_go123_iter_values       | Go 1.23で追加された slices.Values() のサンプルです                         |
+| slice_iter_all.go                | slice_go123_iter_all          | Go 1.23で追加された slices.All() のサンプルです                            |

examples/basic/slices/examples.go

@@ -33,4 +33,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["slice_convert_to_array_go117"] = ConvertToArrayGo117
 	m["slice_append_special_behavior"] = AppendSpecialBehavior
 	m["slice_go123_iter_values"] = IterValues
+	m["slice_go123_iter_all"] = IterAll
 }

examples/basic/slices/slice_iter_all.go

@@ -0,0 +1,43 @@
+package slices
+
+import (
+	"iter"
+	"maps"
+	"slices"
+
+	"github.com/devlights/gomy/output"
+)
+
+// IterAll は、Go 1.23で追加された slices.All() のサンプルです。
+//
+// > All returns an iterator over index-value pairs in the slice in the usual order.
+// > (Allは、スライス要素をインデックス付きで順番に返すイテレータを返します。)
+//
+// 一番シンプルな形のイテレータ関数。元のスライスをそのままインデックス付きのイテレータにしてくれるだけ。
+// iter.Seq2[int, E] を要求する他の関数を呼び出す際などに経由させて使える。
+//
+// # REFERENCES
+//   - https://pkg.go.dev/slices@go1.23.4#All
+func IterAll() error {
+	var (
+		s  []string
+		it iter.Seq2[int, string]
+	)
+
+	s = []string{"golang", "javascript", "java", "csharp", "python", "rust"}
+	it = slices.All(s)
+
+	for i, v := range it {
+		output.Stdoutf("[i, v]", "%d, %v\n", i, v)
+	}
+
+	output.StdoutHr()
+
+	// maps.Collect() は、iter.Seq2[K,V] を受け取り、map[K]V にして返してくれる関数
+	var (
+		m = maps.Collect(it)
+	)
+	output.Stdoutf("[key=3]", m[3])
+
+	return nil
+}