Merge pull request #1449 from future-architect/feature

template

Author: ma91n

source/_posts/20250127a_Go_1.24連載始まります&os.Root、WASMの最新のまとめ.md

@@ -23,7 +23,7 @@ lede: "恒例のGo新リリース記念連載が始まります。今回の1.24
 | 1/27  | インデックス＋`os.Root`+WASM  | 渋川 |
 | 1/28  | testing.Context | 真野さん  |
 | 1/29  | [encoding/jsonのomitzero](/articles/20250129a/)  | 島ノ江さん  |
-| 1/30  | templateの新文法（イテレータ）  | 大江さん  |
+| 1/30  | [templateの新文法（イテレータ）](/articles/20250130a/)  | 大江さん  |
 | 1/31  | testing/synctest + 生成AI  | 棚井さん  |
 | 2/3  | strings関数 + encoding.TextAppender  | 市川燿さん  |
 | 2/4 |  ツール管理回りの進化  | 辻さん |

source/_posts/20250130a_Go_1.24リリース連載_templateの新文法（イテレータ）.md

@@ -0,0 +1,274 @@
+---
+title: "Go 1.24リリース連載 templateの新文法（イテレータ）"
+date: 2025/01/30 00:00:00
+postid: a
+tag:
+  - Go
+  - Go1.24
+category:
+  - Programming
+thumbnail: /images/20250130a/thumbnail.png
+author: 大江聖太郎, 
+lede: "text/template`でのrange over func、range over intのサポート を取り上げます"
+---
+<img src="/images/20250130a/go1.24.png" alt="" width="800" height="484">
+
+
+# はじめに
+
+TIG所属の大江です。[Go1.24リリース連載](/articles/20250127a/)の4本目です。
+
+本記事では以下の内容を取り上げます。
+
+- `text/template`でのrange over func、range over intのサポート
+
+## アップデート内容
+
+Go1.22で導入された`range over int`, Go1.23で導入された`range over func`が共に`text/template`パッケージで使えるようになりました。
+
+以降では、これらの機能がどのように使えるかを見ていきます。
+
+### range over int
+
+指定された回数、同じ文字を繰り返すテンプレートを書く
+
+#### Go1.23までの場合
+
+テンプレートを使って同じ文字を10回繰り返す場合、以下のようにスライスや配列を生成してからテンプレートに渡す必要がありました。
+
+```go
+package main
+
+import (
+	"log"
+	"os"
+	"text/template"
+)
+
+func main() {
+	numbers := []int{0, 1, 2, 3, 4, 5, 6, 7, 8, 9}
+
+	// このピリオドは上で定義したnumbersのスライス
+	tmpl := `{{range .}}Bonjour
+{{end}}`
+
+	t := template.Must(template.New("").Parse(tmpl))
+	err := t.Execute(os.Stdout, numbers)
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+/// 処理結果
+///
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+
+```
+
+### Go1.24の場合
+
+Go1.24では、range over intにより、以下のようにスライスや配列を用意せず直接テンプレート内で繰り返し回数を指定することが出来るようになりました。
+
+``` go
+package main
+
+import (
+	"log"
+	"os"
+	"text/template"
+)
+
+func main() {
+	// 直接数字で繰り返し回数を指定
+	tmpl := `{{range 10}}Bonjour
+{{end}}`
+
+	t := template.Must(template.New("").Parse(tmpl))
+	err := t.Execute(os.Stdout, nil)
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+/// 処理結果
+///
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+/// Bonjour
+
+```
+
+## range over func
+
+マップの中の一部を抜き出してテンプレートを使って表示する
+
+### Go1.23までの場合
+
+以下では数字と文字の組み合わせの中から、偶数、3の倍数をそれぞれ抜き出し、テンプレートを使って表示します。
+Go1.23までは以下のように、それぞれの関数の戻り値として別のマップに代入するなどしてからテンプレートに渡す必要がありました。
+
+``` go
+package main
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"text/template"
+)
+
+func main() {
+	numbers := map[int]string{
+		1:  "un",
+		2:  "deux",
+		3:  "trois",
+		4:  "quatre",
+		5:  "cinq",
+		6:  "six",
+		7:  "sept",
+		8:  "huit",
+		9:  "neuf",
+		10: "dix",
+	}
+
+	// このピリオドは下で定義したgetMultiples()の戻り値
+	tmpl := `{{range $i, $c := .}}{{$i}}:{{$c}}
+{{end}}`
+
+	t := template.Must(template.New("").Parse(tmpl))
+	fmt.Println("偶数")
+	evenNumbers := getMultiples(numbers, 2)
+	err := t.Execute(os.Stdout, evenNumbers)
+	if err != nil {
+		log.Fatal(err)
+	}
+	fmt.Println("\n3の倍数")
+	threeMultiples := getMultiples(numbers, 3)
+	err = t.Execute(os.Stdout, threeMultiples)
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+func getMultiples(numbers map[int]string, divisor int) map[int]string {
+	multiples := make(map[int]string, 10)
+	for k, v := range numbers {
+		if k%divisor == 0 {
+			multiples[k] = v
+		}
+	}
+	return multiples
+}
+
+/// 処理結果
+/// ※Goのマップでは、反復処理の操作を行う際の順序は保証されていないので順序はランダム
+///
+/// 偶数
+/// 10:dix
+/// 2:deux
+/// 4:quatre
+/// 6:six
+/// 8:huit
+
+/// 3の倍数
+/// 3:trois
+/// 6:six
+/// 9:neuf
+
+```
+
+### Go1.24の場合
+
+新たに導入されたrange over funcを使えば、直接テンプレート内で関数を呼び出し、戻り値を表示することができます。
+なおrange over funcについては、[Go1.23連載の棚井さんの記事](https://future-architect.github.io/articles/20240718a/)を参考にさせていただきました。
+
+```go
+package main
+
+import (
+	"fmt"
+	"iter"
+	"log"
+	"os"
+	"text/template"
+)
+
+func main() {
+	numbers := map[int]string{
+		1:  "un",
+		2:  "deux",
+		3:  "trois",
+		4:  "quatre",
+		5:  "cinq",
+		6:  "six",
+		7:  "sept",
+		8:  "huit",
+		9:  "neuf",
+		10: "dix",
+	}
+
+	// このピリオドは下で定義したgetMultiples()の戻り値
+	tmpl := `{{range $i, $c := .}}{{$i}}:{{$c}}
+{{end}}`
+
+	t := template.Must(template.New("").Parse(tmpl))
+	fmt.Println("偶数")
+	err := t.Execute(os.Stdout, getMultiples(numbers, 2))
+	if err != nil {
+		log.Fatal(err)
+	}
+	fmt.Println("\n3の倍数")
+	err = t.Execute(os.Stdout, getMultiples(numbers, 3))
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+func getMultiples(numbers map[int]string, divisor int) iter.Seq2[int, string] {
+	return func(yield func(int, string) bool) {
+		for k, v := range numbers {
+			if k%divisor == 0 {
+				if !yield(k, v) {
+					return
+				}
+			}
+		}
+	}
+}
+
+/// 処理結果
+/// ※Goのマップでは、反復処理の操作を行う際の順序は保証されていないので数字の順序はランダム
+///
+/// 偶数
+/// 2:deux
+/// 4:quatre
+/// 10:dix
+/// 6:six
+/// 8:huit
+
+/// 3の倍数
+/// 3:trois
+/// 6:six
+/// 9:neuf
+
+```
+
+# おわりに
+
+以上、text/templateパッケージでのrange over int、range over funcについて紹介しました。近年のGoの反復処理のアップデートがさらに加速し、痒い所に手が届くようになった印象です。