Struct Arguments

pub struct Arguments(/* private fields */);

Helper type to keep track of arguments for spawning a process.

Stores the arguments in order, but is aware of key-value pairs to make overriding parameters more predictable.

Notes

Repeated arguments are not supported.

Implementations

impl Arguments

pub fn new() -> Self

Creates a new empty list of arguments.

pub fn set_argument(&mut self, argument: impl Into<String>)

Sets a lone argument.

If the argument is already in the list, nothing happens.

If there’s a key-value pair where the key is identical to the argument, the value of the pair is removed and the key maintains its position.

pub fn set_parameter( &mut self, parameter: impl Into<String>, value: impl Into<String>, )

Sets a key-value pair.

If there is already a pair in the list with the same parameter key, the existing pair keeps its position but the value is updated.

If there is a lone argument that is identical to the parameter key, the value is inserted after it.

pub fn merge_with(&mut self, extra_arguments: Arguments)

Merges two argument lists.

Existing pairs have their values updated if needed, and new pairs and arguments are appended to the end of this list.

pub fn into_arguments(self) -> impl Iterator<Item = String>

Converts this Arguments instance into a list of strings that can be passed when spawning a process.

Trait Implementations

impl Clone for Arguments

fn clone(&self) -> Arguments

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Arguments

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

Formats the value using the given formatter.

impl Default for Arguments

fn default() -> Arguments

Returns the “default value” for a type.

impl PartialEq for Arguments

fn eq(&self, other: &Arguments) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Arguments

impl StructuralPartialEq for Arguments