Merge pull request #373 from devlights/devlights/add-os-dirfs-example-368

Add fileio_fs_dirfs.go

Author: devlights

internal/examples/basic/fileio/README.md

@@ -11,4 +11,4 @@
 |fileio\_null\_writer.go|fileio\_null\_writer|ioutil.Discard のサンプルです.|
 |fileio\_stdin.go|fileio\_stdin\_scanner|os.Stdin と bufio.Scanner のサンプルです.|
 |fileio\_permission.go|fileio\_stat\_permission|os.FileMode でパーミッションを判定するサンプルです.|
-
+|fileio\_fs\_dirfs.go|fileio\_fs\_dirfs|os.DirFS() を利用してファイルの読み込みを行うサンプルです.|

internal/examples/basic/fileio/examples.go

@@ -22,4 +22,5 @@ func (r *register) Regist(m mappings.ExampleMapping) {
 	m["fileio_null_writer"] = NullWriter
 	m["fileio_stdin_scanner"] = StdinWithScanner
 	m["fileio_stat_permission"]= StatPermission
+	m["fileio_fs_dirfs"] = FsDirFS
 }

internal/examples/basic/fileio/fileio_fs_dirfs.go

@@ -0,0 +1,56 @@
+package fileio
+
+import (
+	"io"
+	"io/fs"
+	"os"
+
+	"github.com/devlights/gomy/output"
+)
+
+// FsDirFS は、 os.DirFS() を利用してファイルの読み込みを行うサンプルです.
+//
+// REFERENCES:
+//   - https://golang.org/pkg/io/fs/
+//   - https://golang.org/pkg/os/#DirFS
+func FsDirFS() error {
+	//
+	// io/fs パッケージは Go1.16で追加されたパッケージ.
+	// このパッケージの目的はファイルシステムを抽象化するためにある.
+	//
+	// 今までの io.Reader や io.Writer が読み書きを抽象化していたのと
+	// 同様にファイルシステムという概念も抽象化してしまおうという事になる.
+	//
+	// osパッケージ側には DirFS という関数が追加され、ここから特定のディレクトリの
+	// fs.FS を取得することが出来るようになった。
+	//
+
+	//
+	// 以下は os.Open("./.gitpod.yml") しているのと同じことになる
+	//
+	var (
+		dir  fs.FS
+		file fs.File
+		buf  []byte
+		err  error
+	)
+	
+	// DirFSを利用して、特定のディレクトリを指す fs.FS を取得
+	dir = os.DirFS(".")
+	output.Stdoutf("[DirFS]", "%[1]v(%[1]T)\n", dir)
+
+	// 対象の fs.FS から、そのディレクトリ内のファイルを開く
+	file, err = dir.Open(".gitpod.yml")
+	if err != nil {
+		return err
+	}
+
+	buf, err = io.ReadAll(file)
+	if err != nil {
+		return nil
+	}
+
+	output.Stdoutl("[.gitpod.yml]", string(buf))
+
+	return nil
+}