Struct getopts::Matches

pub struct Matches {
    pub(crate) opts: Vec<Opt>,
    pub(crate) vals: Vec<Vec<(usize, Optval)>>,
    pub free: Vec<String>,
}

The result of checking command line arguments. Contains a vector of matches and a vector of free strings.

Fields

opts: Vec<Opt>

Options that matched

vals: Vec<Vec<(usize, Optval)>>

Values of the Options that matched and their positions

free: Vec<String>

Free string fragments

Implementations

impl Matches

pub(crate) fn opt_vals(&self, nm: &str) -> Vec<(usize, Optval)>

pub(crate) fn opt_val(&self, nm: &str) -> Option<Optval>

pub fn opt_defined(&self, nm: &str) -> bool

Returns true if an option was defined

pub fn opt_present(&self, nm: &str) -> bool

Returns true if an option was matched.

pub fn opt_count(&self, nm: &str) -> usize

Returns the number of times an option was matched.

pub fn opt_positions(&self, nm: &str) -> Vec<usize>

Returns a vector of all the positions in which an option was matched.

pub fn opts_present(&self, names: &[String]) -> bool

Returns true if any of several options were matched.

pub fn opts_str(&self, names: &[String]) -> Option<String>

Returns the string argument supplied to one of several matching options or None.

pub fn opt_strs(&self, nm: &str) -> Vec<String>

Returns a vector of the arguments provided to all matches of the given option.

Used when an option accepts multiple values.

pub fn opt_strs_pos(&self, nm: &str) -> Vec<(usize, String)>

Returns a vector of the arguments provided to all matches of the given option, together with their positions.

Used when an option accepts multiple values.

pub fn opt_str(&self, nm: &str) -> Option<String>

Returns the string argument supplied to a matching option or None.

pub fn opt_default(&self, nm: &str, def: &str) -> Option<String>

Returns the matching string, a default, or None.

Returns None if the option was not present, def if the option was present but no argument was provided, and the argument if the option was present and an argument was provided.

pub fn opt_get<T>(&self, nm: &str) -> Result<Option<T>, T::Err>

where T: FromStr,

Returns some matching value or None.

Similar to opt_str, also converts matching argument using FromStr.

pub fn opt_get_default<T>(&self, nm: &str, def: T) -> Result<T, T::Err>

where T: FromStr,

Returns a matching value or default.

Similar to opt_default, except the two differences. Instead of returning None when argument was not present, return def. Instead of returning &str return type T, parsed using str::parse().

Trait Implementations

impl Clone for Matches

fn clone(&self) -> Matches

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Matches

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

Formats the value using the given formatter.

impl PartialEq for Matches

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Matches

impl StructuralPartialEq for Matches