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

Author: devlights

examples/basic/examples.go

@@ -33,6 +33,7 @@ import (
 	"github.com/devlights/try-golang/examples/basic/interfaces"
 	"github.com/devlights/try-golang/examples/basic/internalpkg"
 	"github.com/devlights/try-golang/examples/basic/ioop"
+	"github.com/devlights/try-golang/examples/basic/iters"
 	"github.com/devlights/try-golang/examples/basic/jsonop"
 	"github.com/devlights/try-golang/examples/basic/literals"
 	"github.com/devlights/try-golang/examples/basic/logging"
@@ -122,6 +123,7 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	imports.NewRegister().Regist(m)
 	internalpkg.NewRegister().Regist(m)
 	ioop.NewRegister().Regist(m)
+	iters.NewRegister().Regist(m)
 	jsonop.NewRegister().Regist(m)
 	osop.NewRegister().Regist(m)
 	profiles.NewRegister().Regist(m)

examples/basic/iters/README.md

@@ -0,0 +1,8 @@
+# サンプルリスト
+
+このディレクトリには以下のサンプルがあります。
+
+| file                | example name            | note                                                        |
+| ------------------- | ----------------------- | ----------------------------------------------------------- |
+| range_over_func1.go | iters_range_over_func_1 | Go 1.23 で正式導入となった Range-Over-Func のサンプルです。 |
+|                     |                         |                                                             |

examples/basic/iters/doc.go

@@ -0,0 +1,4 @@
+/*
+Package iters -- Go 1.23 で追加された iterパッケージとRange-Over-Func機能についてサンプルが配置されています.
+*/
+package iters

examples/basic/iters/examples.go

@@ -0,0 +1,19 @@
+package iters
+
+import (
+	"github.com/devlights/try-golang/mapping"
+)
+
+type (
+	register struct{}
+)
+
+// NewRegister -- このパッケージ用のサンプルを登録する mapping.Register を生成します。
+func NewRegister() mapping.Register {
+	return new(register)
+}
+
+// Regist -- 登録します.
+func (r *register) Regist(m mapping.ExampleMapping) {
+	m["iters_range_over_func_1"] = Go123RangeOverFunc1
+}

examples/basic/iters/range_over_func1.go

@@ -0,0 +1,59 @@
+package iters
+
+import "github.com/devlights/gomy/output"
+
+// Go123RangeOverFunc1 は、Go 1.23 で正式導入となった Range-Over-Func のサンプルです。
+//
+// Range-Over-Func は、独自のイテレータを作成出来るようになる機能です。
+// 以下の関数パターンがサポートされています。
+//
+//   - func(func() bool)     : ループ変数に値を渡さないタイプ
+//   - func(func(k) bool)    : 1つのループ変数に値を渡すタイプ
+//   - func(func(k, v) bool) : 2つのループ変数に値を渡すタイプ
+//
+// 本サンプルは、func(func() 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 Go123RangeOverFunc1() error {
+	var (
+		// ２回分のイテレータ。ループ変数に値を渡さないタイプ。
+		twoTimes = func(yield func() bool) {
+			if !yield() {
+				return
+			}
+
+			if !yield() {
+				return
+			}
+		}
+		// クロージャを使って、指定された回数ループするイテレータを返す。
+		nTimes = func(times int) func(func() bool) {
+			return func(yield func() bool) {
+				for range times {
+					if !yield() {
+						return
+					}
+				}
+			}
+		}
+	)
+
+	// func() bool のイテレータなので、ループ毎に受け取るものが無い。
+	// (range over twoTimes (variable of type func(yield func() bool)) permits no iteration variables)
+	for range twoTimes {
+		output.Stdoutl("[twoTimes ]", "call")
+	}
+
+	for range nTimes(5) {
+		output.Stdoutl("[nTimes(5)]", "call")
+	}
+
+	return nil
+}