Add examples/basic/cmpop/or.go

Author: devlights

examples/basic/cmpop/README.md

@@ -0,0 +1,7 @@
+# サンプルリスト
+
+このディレクトリには以下のサンプルがあります。
+
+| file  | example name | note                                      |
+| ----- | ------------ | ----------------------------------------- |
+| or.go | cmpop_or     | cmp.Or\[T comparable\]\(\) のサンプルです |

examples/basic/cmpop/doc.go

@@ -0,0 +1,4 @@
+/*
+Package cmpop -- cmpパッケージのサンプルが配置されています。
+*/
+package cmpop

examples/basic/cmpop/examples.go

@@ -0,0 +1,17 @@
+package cmpop
+
+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["cmpop_or"] = Or
+}

examples/basic/cmpop/or.go

@@ -0,0 +1,62 @@
+package cmpop
+
+import (
+	"cmp"
+
+	"github.com/devlights/gomy/output"
+)
+
+// Or は、cmp.Or[T comparable]() のサンプルです。
+// cmp.Or は、Go 1.22 で追加されました。
+//
+// > Or returns the first of its arguments that is not equal to the zero value. If no argument is non-zero, it returns the zero value.
+//
+// > (Orは、引数のうちゼロ値ではない最初の引数を返す。どの引数もゼロ値ではない場合、ゼロ値を返す。)
+//
+// comparableが対象となるので、以下に対して利用できる。
+//
+//   - booleans
+//   - numbers
+//   - strings
+//   - pointers
+//   - channels
+//   - arrays of comparable types
+//   - structs whose fields are all comparable types
+//
+// # REFERENCES
+//   - https://pkg.go.dev/cmp#Or
+//   - https://pkg.go.dev/builtin#comparable
+func Or() error {
+	type (
+		V struct {
+			Val int
+		}
+	)
+	var (
+		ints = []int{0, 0, 99, 1, 0}
+		strs = []string{"", "hello", "world", ""}
+		objs = []*V{nil, {999}, nil}
+	)
+
+	output.Stdoutl("[non-zero]", cmp.Or(ints...))
+	output.Stdoutl("[non-zero]", cmp.Or(strs...))
+	output.Stdoutl("[non-zero]", cmp.Or(objs...))
+
+	return nil
+
+	/*
+		$ task
+		task: [build] go build .
+		task: [run] ./try-golang -onetime
+
+		ENTER EXAMPLE NAME: cmpop_or
+
+		[Name] "cmpop_or"
+		[non-zero]           99
+		[non-zero]           hello
+		[non-zero]           &{999}
+
+
+		[Elapsed] 53.06µs
+	*/
+}

examples/basic/examples.go

@@ -9,6 +9,7 @@ import (
 	"github.com/devlights/try-golang/examples/basic/builtins"
 	"github.com/devlights/try-golang/examples/basic/byteop"
 	"github.com/devlights/try-golang/examples/basic/cmdexec"
+	"github.com/devlights/try-golang/examples/basic/cmpop"
 	"github.com/devlights/try-golang/examples/basic/comments"
 	"github.com/devlights/try-golang/examples/basic/constants"
 	"github.com/devlights/try-golang/examples/basic/containers"
@@ -95,6 +96,7 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	bufferop.NewRegister().Regist(m)
 	byteop.NewRegister().Regist(m)
 	cmdexec.NewRegister().Regist(m)
+	cmpop.NewRegister().Regist(m)
 	comments.NewRegister().Regist(m)
 	constants.NewRegister().Regist(m)
 	containers.NewRegister().Regist(m)