Merge pull request #831 from devlights/add-flag-arg-example

Author: devlights

examples/basic/flags/README.md

@@ -2,13 +2,14 @@
 
 このディレクトリには以下のサンプルがあります。
 
-| file        | example name   | note                                               |
-| ----------- | -------------- | -------------------------------------------------- |
-| flagset.go  | flags_flagset  | flag.Flagset のサンプルです                        |
-| var.go      | flags_var      | flag.Var() のサンプルです                          |
-| int.go      | flags_int      | flag.Int(), flag.IntVar() のサンプルです           |
-| bool.go     | flags_bool     | flag.Bool(), flag.BoolVar() のサンプルです         |
-| string.go   | flags_string   | flag.String(), flag.StringVar() のサンプルです     |
-| duration.go | flags_duration | flag.Duration(), flag.DurationVar() のサンプルです |
-| func.go     | flags_func     | flag.Func() のサンプルです                         |
-| textvar.go  | flags_textvar  | flag.TextVar() のサンプルです                      |
+| file        | example name   | note                                                              |
+| ----------- | -------------- | ----------------------------------------------------------------- |
+| flagset.go  | flags_flagset  | flag.Flagset のサンプルです                                       |
+| var.go      | flags_var      | flag.Var() のサンプルです                                         |
+| int.go      | flags_int      | flag.Int(), flag.IntVar() のサンプルです                          |
+| bool.go     | flags_bool     | flag.Bool(), flag.BoolVar() のサンプルです                        |
+| string.go   | flags_string   | flag.String(), flag.StringVar() のサンプルです                    |
+| duration.go | flags_duration | flag.Duration(), flag.DurationVar() のサンプルです                |
+| func.go     | flags_func     | flag.Func() のサンプルです                                        |
+| textvar.go  | flags_textvar  | flag.TextVar() のサンプルです                                     |
+| nargs.go    | flags_nargs    | flag.Arg(), flag.Args(), flag.NArg(), flag.NFlag() のサンプルです |

examples/basic/flags/examples.go

@@ -21,4 +21,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["flags_duration"] = Duration
 	m["flags_func"] = Func
 	m["flags_textvar"] = TextVar
+	m["flags_nargs"] = Nargs
 }

examples/basic/flags/nargs.go

@@ -0,0 +1,41 @@
+package flags
+
+import (
+	"flag"
+
+	"github.com/devlights/gomy/output"
+)
+
+// Nargs は、flag.Arg(), flag.Args(), flag.NArg(), flag.NFlag() のサンプルです.
+//
+//   - flag.NFlag() は、処理したフラグの数
+//   - flag.NArg()  は、処理していない引数の数
+//   - flag.Arg(i)  は、処理していない引数のN番目を取得
+//   - flag.Args()  は、処理していない引数リストを取得
+//
+// # REFERENCES
+//   - https://pkg.go.dev/flag@go1.22.4#Arg
+//   - https://pkg.go.dev/flag@go1.22.4#Args
+//   - https://pkg.go.dev/flag@go1.22.4#NArg
+//   - https://pkg.go.dev/flag@go1.22.4#NFlag
+func Nargs() error {
+	var (
+		fs = flag.NewFlagSet("", flag.ContinueOnError)
+
+		_ = fs.Int("i", 0, "int value")
+		_ = fs.String("s", "", "string value")
+	)
+
+	fs.Parse([]string{"-i", "100", "-s", "hello", "out.txt", "out2.txt"})
+
+	output.Stdoutl("[NFlag][処理したフラグの数    ]", fs.NFlag())
+	output.Stdoutl("[NArg ][処理していない引数の数]", fs.NArg())
+
+	for i := range fs.NArg() {
+		output.Stdoutl("[Arg  ]", fs.Arg(i))
+	}
+
+	output.Stdoutl("[Args ]", fs.Args())
+
+	return nil
+}