Struct ra_ap_stdx::JodChild
source · [−]#[repr(transparent)]pub struct JodChild(pub Child);
Tuple Fields
0: Child
Implementations
sourceimpl JodChild
impl JodChild
pub fn into_inner(self) -> Child
Methods from Deref<Target = Child>
1.0.0 · sourcepub fn kill(&mut self) -> Result<(), Error>
pub fn kill(&mut self) -> Result<(), Error>
Forces the child process to exit. If the child has already exited, an InvalidInput
error is returned.
The mapping to ErrorKind
s is not part of the compatibility contract of the function.
This is equivalent to sending a SIGKILL on Unix platforms.
Examples
Basic usage:
use std::process::Command;
let mut command = Command::new("yes");
if let Ok(mut child) = command.spawn() {
child.kill().expect("command wasn't running");
} else {
println!("yes command didn't start");
}
1.3.0 · sourcepub fn id(&self) -> u32
pub fn id(&self) -> u32
Returns the OS-assigned process identifier associated with this child.
Examples
Basic usage:
use std::process::Command;
let mut command = Command::new("ls");
if let Ok(child) = command.spawn() {
println!("Child's ID is {}", child.id());
} else {
println!("ls command didn't start");
}
1.0.0 · sourcepub fn wait(&mut self) -> Result<ExitStatus, Error>
pub fn wait(&mut self) -> Result<ExitStatus, Error>
Waits for the child to exit completely, returning the status that it exited with. This function will continue to have the same return value after it has been called at least once.
The stdin handle to the child process, if any, will be closed before waiting. This helps avoid deadlock: it ensures that the child does not block waiting for input from the parent, while the parent waits for the child to exit.
Examples
Basic usage:
use std::process::Command;
let mut command = Command::new("ls");
if let Ok(mut child) = command.spawn() {
child.wait().expect("command wasn't running");
println!("Child has finished its execution!");
} else {
println!("ls command didn't start");
}
1.18.0 · sourcepub fn try_wait(&mut self) -> Result<Option<ExitStatus>, Error>
pub fn try_wait(&mut self) -> Result<Option<ExitStatus>, Error>
Attempts to collect the exit status of the child if it has already exited.
This function will not block the calling thread and will only check to see if the child process has exited or not. If the child has exited then on Unix the process ID is reaped. This function is guaranteed to repeatedly return a successful exit status so long as the child has already exited.
If the child has exited, then Ok(Some(status))
is returned. If the
exit status is not available at this time then Ok(None)
is returned.
If an error occurs, then that error is returned.
Note that unlike wait
, this function will not attempt to drop stdin.
Examples
Basic usage:
use std::process::Command;
let mut child = Command::new("ls").spawn().unwrap();
match child.try_wait() {
Ok(Some(status)) => println!("exited with: {status}"),
Ok(None) => {
println!("status not ready yet, let's really wait");
let res = child.wait();
println!("result: {res:?}");
}
Err(e) => println!("error attempting to wait: {e}"),
}
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for JodChild
impl Send for JodChild
impl Sync for JodChild
impl Unpin for JodChild
impl UnwindSafe for JodChild
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more