Merge pull request #665 from devlights:add-builtin-examples

Add builtin func examples

Author: devlights

examples/basic/builtins/README.md

@@ -4,6 +4,8 @@
 
 |file|example name|note|
 |----|------------|----|
+|copy.go|builtin\_copy|ビルトイン関数 copy についてのサンプルです.|
+|delete.go|builtin\_delete|ビルトイン関数 delete についてのサンプルです.|
 |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/copy.go

@@ -0,0 +1,50 @@
+package builtins
+
+import "github.com/devlights/gomy/output"
+
+// Copy は、ビルトイン関数 copy についてのサンプルです.
+//
+// # REFERENCES
+//   - https://pkg.go.dev/builtin@go1.21.0#copy
+func Copy() error {
+	//
+	// copy(dst, src) は、srcからdstへ要素をコピーする
+	//   - 特例として dst=[]byte, src=string の場合は動作するようになっている
+	//
+	var (
+		src1 = []int{1, 2, 3, 4, 5}
+		src2 = src1[:3]
+		dst1 = make([]int, len(src1))
+		dst2 = make([]int, len(src1)-1)
+		dst3 = make([]int, len(src1)-1)
+		p    = func() {
+			output.Stdoutl("[src1]", src1)
+			output.Stdoutl("[src2]", src2)
+			output.Stdoutl("[dst1]", dst1)
+			output.Stdoutl("[dst2]", dst2)
+			output.Stdoutl("[dst3]", dst3)
+			output.StdoutHr()
+		}
+	)
+
+	p()
+	copy(dst1, src1)
+	copy(dst2, src1)
+	copy(dst3, src2)
+	p()
+	dst1[0] = 100
+	dst2[0] = 200
+	dst3[0] = 300
+	p()
+
+	var (
+		dst4 = make([]byte, 10)
+		src3 = "hello world"
+	)
+
+	// dst=[]byte, src=string は型が異なるが特別に許可される
+	copy(dst4, src3)
+	output.Stdoutl("[dst4]", dst4)
+
+	return nil
+}

examples/basic/builtins/delete.go

@@ -0,0 +1,30 @@
+package builtins
+
+import "github.com/devlights/gomy/output"
+
+// Delete は、ビルトイン関数 delete についてのサンプルです.
+//
+// # REFERENCES
+//   - https://pkg.go.dev/builtin@go1.21.0#delete
+func Delete() error {
+	//
+	// delete は、mapから特定のキーを削除するビルトイン関数
+	//   - 存在しないキーを指定してもエラーにはならない
+	//
+	var (
+		m = map[string]int{
+			"apple": 100,
+			"ringo": 200,
+		}
+		p = func(m map[string]int) {
+			output.Stdoutl("[map]", m)
+		}
+	)
+
+	p(m)
+	delete(m, "ringo")
+	delete(m, "hoge")
+	p(m)
+
+	return nil
+}

examples/basic/builtins/examples.go

@@ -16,4 +16,6 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["builtin_print"] = PrintFunc
 	m["builtin_minmax"] = MinMax
 	m["builtin_clear"] = Clear
+	m["builtin_delete"] = Delete
+	m["builtin_copy"] = Copy
 }