aboutsummaryrefslogtreecommitdiff
path: root/core/os/env.odin
diff options
context:
space:
mode:
authorJeroen van Rijn <Kelimion@users.noreply.github.com>2026-02-09 15:50:21 +0100
committerJeroen van Rijn <Kelimion@users.noreply.github.com>2026-02-09 15:50:21 +0100
commite7dbabf6681e4e6bcae33398e939c2c9c3cdc879 (patch)
tree91f25462cc2e9f3adf9884720b7f104d4d6d59f5 /core/os/env.odin
parent8ed264680b1f3f94b6aa5176824d4ccadfc30322 (diff)
core:os -> core:os/old && core:os/os2 -> core:os
Diffstat (limited to 'core/os/env.odin')
-rw-r--r--core/os/env.odin122
1 files changed, 122 insertions, 0 deletions
diff --git a/core/os/env.odin b/core/os/env.odin
new file mode 100644
index 000000000..310d45af1
--- /dev/null
+++ b/core/os/env.odin
@@ -0,0 +1,122 @@
+package os2
+
+import "base:runtime"
+import "core:strings"
+
+// `get_env` retrieves the value of the environment variable named by the key
+// It returns the value, which will be empty if the variable is not present
+// To distinguish between an empty value and an unset value, use lookup_env
+// NOTE: the value will be allocated with the supplied allocator
+@(require_results)
+get_env_alloc :: proc(key: string, allocator: runtime.Allocator) -> string {
+ value, _ := lookup_env(key, allocator)
+ return value
+}
+
+// `get_env` retrieves the value of the environment variable named by the key
+// It returns the value, which will be empty if the variable is not present
+// To distinguish between an empty value and an unset value, use lookup_env
+// NOTE: this version takes a backing buffer for the string value
+@(require_results)
+get_env_buf :: proc(buf: []u8, key: string) -> string {
+ value, _ := lookup_env(buf, key)
+ return value
+}
+
+get_env :: proc{get_env_alloc, get_env_buf}
+
+// `lookup_env` gets the value of the environment variable named by the key
+// If the variable is found in the environment the value (which can be empty) is returned and the boolean is true
+// Otherwise the returned value will be empty and the boolean will be false
+// NOTE: the value will be allocated with the supplied allocator
+@(require_results)
+lookup_env_alloc :: proc(key: string, allocator: runtime.Allocator) -> (value: string, found: bool) {
+ return _lookup_env_alloc(key, allocator)
+}
+
+// This version of `lookup_env` doesn't allocate and instead requires the user to provide a buffer.
+// Note that it is limited to environment names and values of 512 utf-16 values each
+// due to the necessary utf-8 <> utf-16 conversion.
+@(require_results)
+lookup_env_buf :: proc(buf: []u8, key: string) -> (value: string, err: Error) {
+ return _lookup_env_buf(buf, key)
+}
+
+lookup_env :: proc{lookup_env_alloc, lookup_env_buf}
+
+// set_env sets the value of the environment variable named by the key
+// Returns Error on failure
+set_env :: proc(key, value: string) -> Error {
+ return _set_env(key, value)
+}
+
+// unset_env unsets a single environment variable
+// Returns true on success, false on failure
+unset_env :: proc(key: string) -> bool {
+ return _unset_env(key)
+}
+
+clear_env :: proc() {
+ _clear_env()
+}
+
+
+// environ returns a copy of strings representing the environment, in the form "key=value"
+// NOTE: the slice of strings and the strings with be allocated using the supplied allocator
+@(require_results)
+environ :: proc(allocator: runtime.Allocator) -> ([]string, Error) {
+ return _environ(allocator)
+}
+
+// Always allocates for consistency.
+replace_environment_placeholders :: proc(path: string, allocator: runtime.Allocator) -> (res: string) {
+ path := path
+
+ sb: strings.Builder
+ strings.builder_init_none(&sb, allocator)
+
+ for len(path) > 0 {
+ switch path[0] {
+ case '%': // Windows
+ when ODIN_OS == .Windows {
+ for r, i in path[1:] {
+ if r == '%' {
+ env_key := path[1:i+1]
+ env_val := get_env(env_key, context.temp_allocator)
+ strings.write_string(&sb, env_val)
+ path = path[i+1:] // % is part of key, so skip 1 character extra
+ }
+ }
+ } else {
+ strings.write_rune(&sb, rune(path[0]))
+ }
+
+ case '$': // Posix
+ when ODIN_OS != .Windows {
+ env_key := ""
+ dollar_loop: for r, i in path[1:] {
+ switch r {
+ case 'A'..='Z', 'a'..='z', '0'..='9', '_': // Part of key ident
+ case:
+ env_key = path[1:i+1]
+ break dollar_loop
+ }
+ }
+ if len(env_key) > 0 {
+ env_val := get_env(env_key, context.temp_allocator)
+ strings.write_string(&sb, env_val)
+ path = path[len(env_key):]
+ }
+
+ } else {
+ strings.write_rune(&sb, rune(path[0]))
+ }
+
+ case:
+ strings.write_rune(&sb, rune(path[0]))
+ }
+
+ path = path[1:]
+ }
+ return strings.to_string(sb)
+} \ No newline at end of file