Struct Command

pub struct Command { /* private fields */ }

Build a command to execute. This has an API which is deliberately similar to std::process::Command.

let err = exec::Command::new("echo")
    .arg("hello")
    .arg("world")
    .exec();
println!("Error: {}", err);

If the exec function succeeds, it will never return.

Implementations

impl Command

pub fn new<S: AsRef<OsStr>>(program: S) -> Command

Create a new command builder, specifying the program to run. The program will be searched for using the usual rules for PATH.

Examples found in repository

examples/exec.rs (line 15)

fn main() {
    let argv: Vec<String> = env::args().skip(1).collect();
    if argv.len() < 1 {
        println!("Must specify command to execute");
        process::exit(1);
    }

    // Exec the specified program.  If all goes well, this will never
    // return.  If it does return, it will always retun an error.
    let err = exec::Command::new(&argv[0]).args(&argv).exec();
    println!("Error: {}", err);
    process::exit(1);
}

pub fn arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut Command

Add an argument to the command builder. This can be chained.

pub fn args<S: AsRef<OsStr>>(&mut self, args: &[S]) -> &mut Command

Add multiple arguments to the command builder. This can be chained.

let err = exec::Command::new("echo")
    .args(&["hello", "world"])
    .exec();
println!("Error: {}", err);

Examples found in repository

examples/exec.rs (line 15)

fn main() {
    let argv: Vec<String> = env::args().skip(1).collect();
    if argv.len() < 1 {
        println!("Must specify command to execute");
        process::exit(1);
    }

    // Exec the specified program.  If all goes well, this will never
    // return.  If it does return, it will always retun an error.
    let err = exec::Command::new(&argv[0]).args(&argv).exec();
    println!("Error: {}", err);
    process::exit(1);
}

pub fn exec(&mut self) -> Error

Execute the command we built. If this function succeeds, it will never return.

Examples found in repository

examples/exec.rs (line 15)

fn main() {
    let argv: Vec<String> = env::args().skip(1).collect();
    if argv.len() < 1 {
        println!("Must specify command to execute");
        process::exit(1);
    }

    // Exec the specified program.  If all goes well, this will never
    // return.  If it does return, it will always retun an error.
    let err = exec::Command::new(&argv[0]).args(&argv).exec();
    println!("Error: {}", err);
    process::exit(1);
}