Add byteop/go124_bytes_lines.go

Author: devlights

examples/basic/byteop/README.md

@@ -2,7 +2,9 @@
 
 このディレクトリには以下のサンプルがあります。
 
-| file                     | example name                 | note                                          |
-| ------------------------ | ---------------------------- | --------------------------------------------- |
-| reader_from_byteslice.go | byteop_reader_from_byteslice | []byte から io.Reader を生成するサンプルです. |
-| using_repeat.go          | byteop_using_repeat          | bytes.Repeat() のサンプルです                 |
+| file                     | example name                 | note                                               |
+| ------------------------ | ---------------------------- | -------------------------------------------------- |
+| reader_from_byteslice.go | byteop_reader_from_byteslice | []byte から io.Reader を生成するサンプルです.      |
+| using_repeat.go          | byteop_using_repeat          | bytes.Repeat() のサンプルです                      |
+| cut_prefix_suffix.go     | byteop_cut_prefix_suffix     | bytes.{CutPrefix,CutSuffix} のサンプルです.        |
+| go124_bytes_lines.go     | byteop_go124_bytes_lines     | Go 1.24 で追加された bytes.Lines() のサンプルです. |

examples/basic/byteop/examples.go

@@ -16,4 +16,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["byteop_reader_from_byteslice"] = ReaderFromByteSlice
 	m["byteop_cut_prefix_suffix"] = CutPrefixSuffix
 	m["byteop_using_repeat"] = UsingRepeat
+	m["byteop_go124_bytes_lines"] = Go124BytesLines
 }

examples/basic/byteop/go124_bytes_lines.go

@@ -0,0 +1,61 @@
+package byteop
+
+import (
+	"bytes"
+	"fmt"
+	"iter"
+	"os"
+)
+
+// Go124BytesLines は、Go 1.24 で追加された bytes.Lines() のサンプルです.
+//
+// Go 1.23 で追加されたイテレータを返すようになっています。
+// bytes.Lines()は、バイト列を '\n' で区切ったデータをイテレータで提供してくれます。
+// このデータには '\n' 自身も付いた状態で取得出来るので、その点には注意が必要。
+// (fmt.Println()でそのまま出力すると２個改行が入ることになる)
+//
+// # REFERENCES
+//   - https://pkg.go.dev/bytes@go1.24.0#Lines
+//   - https://tip.golang.org/doc/go1.24#bytespkgbytes
+//   - https://tip.golang.org/doc/go1.23#iterators
+func Go124BytesLines() error {
+	var (
+		// 最初のN行のみに絞るためのイテレータ関数
+		firstN = func(n int, lines iter.Seq[[]byte]) iter.Seq[[]byte] {
+			return func(yield func([]byte) bool) {
+				count := 0
+				for line := range lines {
+					if count >= n || !yield(line) {
+						return
+					}
+
+					count++
+				}
+			}
+		}
+		// 前に番号を付与するイテレータ
+		withLineNum = func(lines iter.Seq[[]byte]) iter.Seq[string] {
+			return func(yield func(string) bool) {
+				count := 1
+				for line := range lines {
+					if !yield(fmt.Sprintf("%2d: %s", count, line)) {
+						return
+					}
+
+					count++
+				}
+			}
+		}
+
+		data, _ = os.ReadFile("README.md") // ファイルデータを読み出して
+		lines   = bytes.Lines(data)        // 行単位にして
+		first5  = firstN(5, lines)         // 先頭５行のみにして
+		withNum = withLineNum(first5)      // 行番号を付与
+	)
+
+	for line := range withNum {
+		fmt.Printf("%s", line)
+	}
+
+	return nil
+}

go.mod

@@ -1,6 +1,6 @@
 module github.com/devlights/try-golang
 
-go 1.23
+go 1.24
 
 require (
 	github.com/devlights/gomy v0.6.0