Add std::process::Command::envs()

Command::envs() adds a vector of key-value pairs to the child
process environment all at once.  Suggested in #38526.
This commit is contained in:
Zack Weinberg 2017-01-05 15:51:45 -05:00
parent 74e5b7d96a
commit 55a6fdb7fd
2 changed files with 92 additions and 0 deletions

View file

@ -377,6 +377,38 @@ impl Command {
self
}
/// Add or update multiple environment variable mappings.
///
/// # Examples
///
/// Basic usage:
/// ```no_run
/// use std::process::{Command, Stdio};
/// use std::env;
///
/// let filtered_env : Vec<(String, String)> =
/// env::vars().filter(|&(ref k, _)|
/// k == "TERM" || k == "TZ" || k == "LANG" || k == "PATH"
/// ).collect();
///
/// Command::new("printenv")
/// .stdin(Stdio::null())
/// .stdout(Stdio::inherit())
/// .env_clear()
/// .envs(&filtered_env)
/// .spawn()
/// .expect("printenv failed to start");
/// ```
#[stable(feature = "process", since = "1.16.0")]
pub fn envs<K, V>(&mut self, vars: &[(K, V)]) -> &mut Command
where K: AsRef<OsStr>, V: AsRef<OsStr>
{
for &(ref key, ref val) in vars {
self.inner.env(key.as_ref(), val.as_ref());
}
self
}
/// Removes an environment variable mapping.
///
/// # Examples