Merge pull request #246 from devlights/add-hex-dumper-example-#238

Add encoding/hex.Dumper example

Author: devlights

examples/basic/binaries/examples.go

@@ -18,4 +18,5 @@ func NewRegister() mappings.Register {
 func (r *register) Regist(m mappings.ExampleMapping) {
 	m["binary_byteorder"] = ByteOrder
 	m["binary_readwrite"] = readwrite.ReadWrite
+	m["binary_using_hex_dumper"] = UsingHexDumper
 }

examples/basic/binaries/using_hexdumper.go

@@ -0,0 +1,43 @@
+package binaries
+
+import (
+	"encoding/hex"
+	"io"
+	"os"
+	"strings"
+
+	"github.com/devlights/gomy/output"
+)
+
+// UsingHexDumper -- encoding/hex#Dumper のサンプルです。
+func UsingHexDumper() error {
+	// -----------------------------------------------------
+	// encoding/hex#Dumper を利用すると hexdump コマンドを
+	// 実行した場合のような16進数ダンプを出力することができる.
+	//
+	// hex.Dumper は、io.Writer を受け取り、io.WriteCloserを返す.
+	//
+	// 最後に Close を呼ばないと、ダンプ出力の右側に元の値が表示されないので注意
+	// (Close を呼ばないままだと、16進部分のみが出力される)
+	// -----------------------------------------------------
+	var (
+		s      string         = "hello world"
+		r      io.Reader      = strings.NewReader(s)
+		w      io.Writer      = os.Stdout
+		dumper io.WriteCloser = hex.Dumper(w)
+	)
+
+	defer func() {
+		// Close を呼ぶことにより、出力の右側に値が出力される
+		_ = dumper.Close()
+	}()
+
+	output.Stdoutl("[original]", s)
+
+	_, err := io.Copy(dumper, r)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}