std::env

Function var

1.0.0 · source
pub fn var<K: AsRef<OsStr>>(key: K) -> Result<String, VarError>
Expand description

Fetches the environment variable key from the current process.

§Errors

Returns VarError::NotPresent if:

  • The variable is not set.
  • The variable’s name contains an equal sign or NUL ('=' or '\0').

Returns VarError::NotUnicode if the variable’s value is not valid Unicode. If this is not desired, consider using var_os.

§Examples

use std::env;

let key = "HOME";
match env::var(key) {
    Ok(val) => println!("{key}: {val:?}"),
    Err(e) => println!("couldn't interpret {key}: {e}"),
}