Struct Child 

pub struct Child {
    pub stdin: Option<ChildStdin>,
    pub stdout: Option<ChildStdout>,
    pub stderr: Option<ChildStderr>,
    /* private fields */
}

A running or exited process whose handle is owned exactly once.

Fields

stdin: Option<ChildStdin>

A pipe connected to the child’s standard input, when requested.

stdout: Option<ChildStdout>

A pipe connected to the child’s standard output, when requested.

stderr: Option<ChildStderr>

A pipe connected to the child’s standard error, when requested.

Implementations

impl Child

pub const fn id(&self) -> u32

Returns the process identifier captured at creation.

pub fn kill(&mut self) -> Result<()>

Terminates the root process.

Errors

Returns the operating-system error from TerminateProcess.

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

Waits for exit and caches the status.

Errors

Returns an error if waiting or retrieving the exit code fails.

Examples found in repository

examples/suspended_inspection.rs (line 18)

fn main() -> std::io::Result<()> {
    use std::os::windows::io::AsHandle;

    use windows_spawn::Command;

    let mut command = Command::new(r"C:\Windows\System32\cmd.exe");
    command.args(["/D", "/C", "exit /b 0"]);

    let suspended = command.spawn_suspended()?;
    println!("created suspended process {}", suspended.id());
    let _process = suspended.as_handle();
    let _primary_thread = suspended.primary_thread_handle();

    let mut child = suspended.resume()?;
    assert!(child.wait()?.success());
    Ok(())
}

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

Checks for exit without blocking, returning the cached status thereafter.

Errors

Returns an error if querying the process or its exit code fails.

pub fn wait_with_output(self) -> Result<Output>

Waits while draining both output pipes concurrently.

Under crate::DropPolicy::KillTree, descendants are terminated after the root exits and before reader threads are joined. This guarantees EOF even when a grandchild retained a pipe handle.

Errors

Returns an error from process waiting, pipe reading, or Job termination.

Trait Implementations

impl AsHandle for Child

fn as_handle(&self) -> BorrowedHandle<'_>

Borrows the handle.

impl Debug for Child

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

Formats the value using the given formatter.