Merging issue 280 with master changes (#296)

2022-09-20 07:55:05 -05:00
parent 9c8b401de0
commit 0c6a9f3a3d
5 changed files with 293 additions and 5 deletions
@@ -444,6 +444,20 @@ var CLI struct {

 For flags, multiple key+value pairs should be separated by `mapsep:"rune"` tag (defaults to `;`) eg. `--set="key1=value1;key2=value2"`.

+## Pointers
+
+Pointers work like the underlying type, except that you can differentiate between the presence of the zero value and no value being supplied.
+
+For example:
+
+```go
+var CLI struct {
+	Foo *int
+}
+```
+
+Would produce a nil value for `Foo` if no `--foo` argument is supplied, but would have a pointer to the value 0 if the argument `--foo=0` was supplied.
+
 ## Nested data structure

 Kong support a nested data structure as well with `embed:""`. You can combine `embed:""` with `prefix:""`:
@@ -689,4 +703,4 @@ See the [section on hooks](#hooks-beforeresolve-beforeapply-afterapply-and-the-b

 ### Other options

-The full set of options can be found [here](https://godoc.org/github.com/alecthomas/kong#Option).
+The full set of options can be found [here](https://godoc.org/github.com/alecthomas/kong#Option).