Merge pull request #764 from devlights/add-os-unserenv-example

Author: devlights

examples/basic/osop/README.md

@@ -12,3 +12,4 @@
 | expandenv.go   | osop_expandenv      | os.ExpandEnv() のサンプルです。       |
 | expand.go      | osop_expand         | os.Expand() のサンプルです。          |
 | setenv.go      | osop_setenv         | os.Setenv() のサンプルです。          |
+| unsetenv.go    | osop_unsetenv       | os.Unsetenv() のサンプルです。        |

examples/basic/osop/examples.go

@@ -21,4 +21,5 @@ func (r *register) Regist(m mapping.ExampleMapping) {
 	m["osop_expandenv"] = ExpandEnv
 	m["osop_expand"] = Expand
 	m["osop_setenv"] = Setenv
+	m["osop_unsetenv"] = Unsetenv
 }

examples/basic/osop/unsetenv.go

@@ -0,0 +1,66 @@
+package osop
+
+import (
+	"os"
+
+	"github.com/devlights/gomy/output"
+)
+
+// Unsetenv は、os.Unsetenv() のサンプルです。
+//
+// 指定された環境変数の値をクリアします。
+// 一時的な環境変数を用意する際に、os.Setenv()とペアで以下のように
+// よく利用される。
+//
+//	os.Setenv("MYENV", "HELLOWORLD")
+//	defer os.Unsetenv("MYENV")
+//
+// # REFERENCES
+//
+//   - https://pkg.go.dev/os@go1.22.0#Unsetenv
+func Unsetenv() error {
+	const (
+		ENVKEY = "MYENV"
+		ENVVAL = "HELLOWORLD"
+	)
+
+	var (
+		env string
+		ok  bool
+		err error
+	)
+
+	err = os.Setenv(ENVKEY, ENVVAL)
+	if err != nil {
+		return err
+	}
+
+	env, ok = os.LookupEnv(ENVKEY)
+	output.Stdoutf("[MYENV(before)]", "VALUE=%q\tOK=%v\n", env, ok)
+
+	err = os.Unsetenv(ENVKEY)
+	if err != nil {
+		return err
+	}
+
+	env, ok = os.LookupEnv(ENVKEY)
+	output.Stdoutf("[MYENV(after )]", "VALUE=%q\tOK=%v\n", env, ok)
+
+	return nil
+
+	/*
+	   $ task
+	   task: [build] go build .
+	   task: [run] ./try-golang -onetime
+
+	   ENTER EXAMPLE NAME: osop_unsetenv
+
+	   [Name] "osop_unsetenv"
+	   [MYENV(before)]      VALUE="HELLOWORLD" OK=true
+	   [MYENV(after )]      VALUE=""   OK=false
+
+
+	   [Elapsed] 70.13µs
+	*/
+
+}