Struct procmd::PipeCommand

pub struct PipeCommand<const N: usize> {
    pub commands: [Command; N],
}

Multiple commands that will be piped.

A PipeCommand can be created by either using the new method or by using the cmd! macro.

Examples

Using the new method combined with Command::new and a simple use of the cmd! macro:

use procmd::{cmd, PipeCommand};
use std::process::Command;

let mut pipe_cmd = PipeCommand::new([Command::new("ls"), cmd!("grep", "example")]);
let child = pipe_cmd.spawn()?;

Using the cmd! macro with the => token to generate a PipeCommand and calling the status method to get the exit status:

use procmd::cmd;

let mut pipe_cmd = cmd!("ls" => "grep", "example");
let exit_status = pipe_cmd.status()?;

Fields

commands: [Command; N]

The commands.

Implementations

impl<const N: usize> PipeCommand<N>

pub fn new(commands: [Command; N]) -> Self

Creates a new PipeCommand.

pub fn spawn(&mut self) -> Result<Child>

Spawns all commands and returns the Child of the last command.

Panics

This method panics if commands is empty.

pub fn output(&mut self) -> Result<Output>

Returns the Output of the last command.

Note that this method still calls Command::spawn on all commands except the last one.

Panics

This method panics if commands is empty.

pub fn status(&mut self) -> Result<ExitStatus>

Returns the ExitStatus of the last command.

Note that this method still calls Command::spawn on all commands except the last one.

Panics

This method panics if commands is empty.

Trait Implementations

impl<const N: usize> Debug for PipeCommand<N>

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.