Struct EnvironmentVariables

pub struct EnvironmentVariables { /* private fields */ }

The environment variables of WslGetDistributionConfiguration.

Implementations

impl EnvironmentVariables

pub fn new() -> Self

Create an empty/null array of environment variables

pub fn len(&self) -> usize

Get the number of environment variables

pub fn get(&self, index: usize) -> Option<(&[u8], &[u8])>

Get the key/value pair at index

pub fn iter(&self) -> impl Iterator<Item = (&[u8], &[u8])>

Iterate over the key/value pairs

Examples found in repository

examples/basic.rs (line 20)

fn main() {
    let ubuntu = "Ubuntu";
    let nonexistant = "Nonexistant";

    let wsl = Library::new().unwrap();
    assert!( wsl.is_distribution_registered(ubuntu));
    assert!(!wsl.is_distribution_registered(nonexistant));
    assert!(wsl.get_distribution_configuration(nonexistant).is_err());

    let cfg = wsl.get_distribution_configuration(ubuntu).unwrap();
    assert!(cfg.default_uid == 0 || (1000 ..= 2000).contains(&cfg.default_uid)); // Root or regular UID
    assert!(cfg.flags & WSL_DISTRIBUTION_FLAGS::DEFAULT == WSL_DISTRIBUTION_FLAGS::DEFAULT);
    assert!((1..=2).contains(&cfg.version)); // WSL version

    println!("Environment varibales:");
    for (k,v) in cfg.default_environment_variables.iter() {
        // XXX: This might be inaccurate / depend on the linux locale?  Good enough for a demo though!
        let k = String::from_utf8_lossy(k);
        let v = String::from_utf8_lossy(v);
        println!("{: <10} = {}", k, v);
    }

    wsl.launch_interactive(ubuntu, "echo testing 123", true).unwrap();

    let stdin  = "echo testing 456\necho PATH: ${PATH}\nasdf";
    let stdout = std::fs::File::create("target/basic.txt").unwrap();
    let stderr = std::fs::File::create("CON").unwrap();
    wsl.launch(ubuntu, "sh", true, stdin, stdout, stderr).unwrap().wait().unwrap();

    println!("\rPress ENTER to quit");
    let _ = std::io::stdin().read_line(&mut String::new());
}

Trait Implementations

impl Default for EnvironmentVariables

fn default() -> Self

Returns the “default value” for a type.

impl Drop for EnvironmentVariables

fn drop(&mut self)

Executes the destructor for this type.

impl<'e> IntoIterator for &'e EnvironmentVariables

type Item = (&'e [u8], &'e [u8])

The type of the elements being iterated over.

type IntoIter = EnvironmentVariablesIter<'e>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.