Add examples/basic/formatting directory & Add example

Author: devlights

examples/basic/examples.go

@@ -13,6 +13,7 @@ import (
 	"github.com/devlights/try-golang/examples/basic/errs"
 	"github.com/devlights/try-golang/examples/basic/fileio"
 	"github.com/devlights/try-golang/examples/basic/filepaths"
+	"github.com/devlights/try-golang/examples/basic/formatting"
 	"github.com/devlights/try-golang/examples/basic/functions"
 	"github.com/devlights/try-golang/examples/basic/helloworld"
 	"github.com/devlights/try-golang/examples/basic/ifs"
@@ -65,6 +66,7 @@ func (r *register) Regist(m mappings.ExampleMapping) {
 	errs.NewRegister().Regist(m)
 	fileio.NewRegister().Regist(m)
 	filepaths.NewRegister().Regist(m)
+	formatting.NewRegister().Regist(m)
 	functions.NewRegister().Regist(m)
 	helloworld.NewRegister().Regist(m)
 	ifs.NewRegister().Regist(m)

examples/basic/formatting/README.md

@@ -0,0 +1,8 @@
+# サンプルリスト
+
+このディレクトリには以下のサンプルがあります。
+
+|file|example name|note|
+|----|------------|----|
+|formatting\_adverb\_explicit\_argument\_indexes.go|formatting\_adverb\_explicit\_argument\_indexes|フォーマッティングの Explicit argument indexes についてのサンプルです。|
+

examples/basic/formatting/doc.go

@@ -0,0 +1,4 @@
+/*
+Package formatting -- 主に fmt.Printf() で指定できる verb や adverb についてのサンプルが配置されています.
+*/
+package formatting

examples/basic/formatting/examples.go

@@ -0,0 +1,19 @@
+package formatting
+
+import (
+	"github.com/devlights/try-golang/mappings"
+)
+
+type (
+	register struct{}
+)
+
+// NewRegister -- このパッケージ用のサンプルを登録する mappings.Register を生成します。
+func NewRegister() mappings.Register {
+	return new(register)
+}
+
+// Regist -- 登録します.
+func (r *register) Regist(m mappings.ExampleMapping) {
+	m["formatting_adverb_explicit_argument_indexes"] = AdverbExplicitArgumentIndexes
+}

examples/basic/formatting/formatting_adverb_explicit_argument_indexes.go

@@ -0,0 +1,42 @@
+package formatting
+
+import "fmt"
+
+// AdverbExplicitArgumentIndexes -- フォーマッティングの Explicit argument indexes についてのサンプルです。
+//
+// REFERENCES:
+//   - https://golang.org/pkg/fmt/
+func AdverbExplicitArgumentIndexes() error {
+	// ------------------------------------------------------------
+	// Go のフォーマット仕様には
+	//   Explicit argument indexes
+	// という仕様がある。
+	//
+	// フォーマット文字列内に以下が指定できる
+	//   - [1]とすると、添字内のパラメータの値を指定できる
+	//     中の数字は、フォーマット文字列の後のパラメータの位置
+	//     (最初のパラメータが 1 )
+	//   - [1]* のようにアスタリスクをつけると、そのパラメータの
+	//     値を指示子の値として利用できる
+	// ------------------------------------------------------------
+
+	// 以下の2つは同じ結果となる
+	i := 10
+	fmt.Printf("%d(%T)\n", i, i)
+	fmt.Printf("%d(%[1]T)\n", i)
+
+	// 以下の2つは同じ結果となる
+	f := 32.8
+	fmt.Printf("%3.2f\n", f)
+	fmt.Printf("%[3]*.[2]*[1]f\n", f, 2, 3)
+
+	// 複雑になるので、あまり意味はないが、以下の様にも出来る
+	var (
+		numberLength = 10
+		totalLength  = numberLength + 5
+	)
+
+	fmt.Printf("% [2]*[1]s\n", fmt.Sprintf("%0[2]*[1]d\n", i, numberLength), totalLength)
+
+	return nil
+}