Add clear builtin function (added go 1.21) example

Author: devlights

examples/basic/builtins/README.md

@@ -6,3 +6,4 @@
 |----|------------|----|
 |printfunc.go|builtin\_print|ビルドイン関数のprintとfmt.Printの違いについてのサンプルです.|
 |minmax.go|builtin\_minmax|Go 1.21 で追加されたビルトイン関数のmin,maxについてのサンプルです.|
+|clear.go|builtin\_clear|Go 1.21 で追加されたビルトイン関数のclearについてのサンプルです.|

examples/basic/builtins/clear.go

@@ -0,0 +1,29 @@
+package builtins
+
+import "github.com/devlights/gomy/output"
+
+// Clear は、Go 1.21 で追加されたビルトイン関数のclearについてのサンプルです.
+func Clear() error {
+	//
+	// Go 1.21 から、clear ビルトイン関数が追加された
+	// 対象となるのは、スライスとマップ。
+	//   - スライスの場合は要素がゼロ値にクリアされる
+	//   - マップの場合はキーが全て削除される
+	//
+	var (
+		s = []int{1, 2, 3}
+		m = map[int]string{100: "hello", 200: "world"}
+		p = func(prefix string) {
+			output.Stdoutf(prefix, "[slice] %v\t[map] %v\n", s, m)
+		}
+	)
+
+	p("before")
+
+	clear(s) // スライスの場合は要素がゼロ値になる。要素数は変わらない。
+	clear(m) // マップの場合はキーがクリアされる。要素数はゼロとなる。
+
+	p("after")
+
+	return nil
+}

examples/basic/builtins/examples.go

@@ -15,4 +15,5 @@ func NewRegister() mapping.Register {
 func (r *register) Regist(m mapping.ExampleMapping) {
 	m["builtin_print"] = PrintFunc
 	m["builtin_minmax"] = MinMax
+	m["builtin_clear"] = Clear
 }

examples/basic/builtins/minmax.go

@@ -6,8 +6,8 @@ import "github.com/devlights/gomy/output"
 //
 // go doc で調べる場合は以下のようにします.
 //
-//	- go doc builtin.max
-//	- go doc builtin.min
+//   - go doc builtin.max
+//   - go doc builtin.min
 //
 // # REFERENCES
 //   - https://go.dev/ref/spec#Min_and_max

examples/singleapp/find_number_of_digits/main.go

@@ -17,4 +17,4 @@ func run() error {
 	fmt.Printf("[ToString] %v\t[Log10] %v\n", lib.UseToString(v), lib.UseLog10(v))
 
 	return nil
-}
+}