Merge pull request #697 from devlights:add-stringer-and-gostringer

Add examples/basic/formatting/stringer_and_gostringer.go

Author: devlights

examples/basic/formatting/README.md

@@ -11,3 +11,4 @@
 |appendf.go|formatting\_appendf|Go 1.19 から追加された fmt.Appendf() のサンプルです|
 |appendln.go|formatting\_appendln|Go 1.19 から追加された fmt.Appendln() のサンプルです|
 |padding\_arbitarylength.go|formatting\_padding\_arbitarylength|文字列をパディングする際の桁数を外から指定するサンプルです|
+|stringer\_and\_gostringer.go|formatting\_stringer\_and\_gostringer|fmt.Stringerとfmt.GoStringerについてのサンプルです|

examples/basic/formatting/examples.go

@@ -21,4 +21,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["formatting_appendln"] = AppendLn
 	m["formatting_padding_arbitary_length"] = PaddingArbitaryLength
 	m["formatting_numbers"] = Numbers
+	m["formatting_stringer_and_gostringer"] = StringerAndGoStringer
 }

examples/basic/formatting/stringer_and_gostringer.go

@@ -0,0 +1,42 @@
+package formatting
+
+import (
+	"encoding/json"
+	"fmt"
+	"strconv"
+)
+
+type _MyInt int
+
+func (me _MyInt) String() string {
+	return fmt.Sprintf("stringer: %d", me)
+}
+
+func (me _MyInt) GoString() string {
+	return fmt.Sprintf("gostring: %d", me)
+}
+
+// StringerAndGoStringer は、fmt.Stringerとfmt.GoStringerについてのサンプルです.
+//
+// # REFERENCES
+//   - https://pkg.go.dev/fmt@go1.21.4#Stringer
+//   - https://pkg.go.dev/fmt@go1.21.4#GoStringer
+func StringerAndGoStringer() error {
+	//
+	// fmt.Stringer と fmt.GoStringer の違い
+	//
+	// どちらも文字列表現のためのインターフェースであるが
+	// fmt.GoStringerの方は GoString() を呼ばれた場合に発動する.
+	// これは、fmt.Printf などで %#v を利用してフォーマットしようとする際に使われる
+	//
+
+	var (
+		i    = _MyInt(100)
+		s    = strconv.Itoa((int)(i))
+		b, _ = json.Marshal(i)
+	)
+
+	fmt.Printf("v: %v\t+v: %+v\t#v: %#v\tjson: %s\ts: %s", i, i, i, b, s)
+
+	return nil
+}