Functions for dealing with environmental variables.

This module reads variables from the external environment, but doesn't write anything back. Use the appropriate OS functions for that.

Code Map

//! Functions for dealing with environmental variables.
module watt.process.environment;


//! Holds environment values.
class Environment
{
public:
	store: string[string];


public:
	this() { }
	//! Is the given key set?
	fn isSet(key: string) bool { }
	//! Get the given key, or return null.
	fn getOrNull(key: string) string { }
	//! Set a key in this environment.
	fn set(key: string, value: string) { }
	//! Remove a key from this environment.
	fn remove(key: string) { }
}

//! Returns an environment that is a copy of the running process'
//! environment.
fn retrieveEnvironment() Environment { }

env := retrieveEnvironment();

assert(env.isSet("PATH") == env.isSet("paTh"));

home := env.getOrNull("HOME");

env.set("key", "banana");
assert(env.getOrNull("KEY") == "banana");

env.set("key", "banana");
assert(env.getOrNull("key") == "banana");
env.remove("key");
assert(env.getOrNull("key") == "");