Merge pull request #878 from devlights/add-go123-iter-examples

Author: devlights

examples/basic/iters/examples.go

@@ -19,4 +19,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["iters_range_over_func_2"] = Go123RangeOverFunc2
 	m["iters_range_over_func_3"] = Go123RangeOverFunc3
 	m["iters_seq"] = IterSeq
+	m["iters_seq2"] = IterSeq2
 }

examples/basic/iters/seq2.go

@@ -0,0 +1,58 @@
+package iters
+
+import (
+	"iter"
+
+	"github.com/devlights/gomy/output"
+)
+
+// IterSeq2 は、Go 1.23 で正式導入となった iter.Seq2 のサンプルです。
+//
+// Range-Over-Func は、独自のイテレータを作成出来るようになる機能です。
+// 以下の関数パターンがサポートされています。
+//
+//   - func(func() bool)     : ループ変数に値を渡さないタイプ
+//   - func(func(v) bool)    : 1つのループ変数に値を渡すタイプ
+//   - func(func(k, v) bool) : 2つのループ変数に値を渡すタイプ
+//
+// Go 1.23 にて追加された iter パッケージには以下の２つの型が定義されています。
+//
+//   - iter.Seq[V any]
+//   - iter.Seq2[K, V any]
+//
+// 上はそれぞれ func(v) bool と func(k, v) bool に対応しており、カスタムイテレータを
+// 戻り値や引数として指定したりする際に、イテレータであると利用者側に伝わりやすくなります。
+//
+// # REFERENCES
+//   - https://tip.golang.org/doc/go1.23
+//   - https://tip.golang.org/blog/range-functions
+//   - https://tip.golang.org/ref/spec#For_range
+//   - https://pkg.go.dev/iter@go1.23.3
+//   - https://zenn.dev/koya_iwamura/articles/7e7482c7222e37
+//   - https://tech.every.tv/entry/2023/12/09/1
+//   - https://future-architect.github.io/articles/20240129a/
+func IterSeq2() error {
+	var (
+		// 指定された文字列を逆順でループ
+		reverse = func(s string) iter.Seq2[int, string] {
+			var (
+				runes   = []rune(s)
+				runeLen = len(runes)
+			)
+
+			return func(yield func(i int, s string) bool) {
+				for i, j := 0, runeLen-1; i < runeLen; i, j = i+1, j-1 {
+					if !yield(i, string(runes[j])) {
+						return
+					}
+				}
+			}
+		}
+	)
+
+	for i, v := range reverse("helloworld") {
+		output.Stdoutf("[reverse(helloworld)]", "%d:%v\n", i, v)
+	}
+
+	return nil
+}