[][src]Struct getopts::Options

pub struct Options { /* fields omitted */ }

A description of the options that a program can handle.

Methods

impl Options[src]

pub fn new() -> Options[src]

Create a blank set of options.

pub fn parsing_style(&mut self, style: ParsingStyle) -> &mut Options[src]

Set the parsing style.

pub fn long_only(&mut self, long_only: bool) -> &mut Options[src]

Set or clear "long options only" mode.

In "long options only" mode, short options cannot be clustered together, and long options can be given with either a single "-" or the customary "--". This mode also changes the meaning of "-a=b"; in the ordinary mode this will parse a short option "-a" with argument "=b"; whereas in long-options-only mode the argument will be simply "b".

pub fn opt(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str,
    hint: &str,
    hasarg: HasArg,
    occur: Occur
) -> &mut Options
[src]

Create a generic option group, stating all parameters explicitly.

pub fn optflag(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str
) -> &mut Options
[src]

Create a long option that is optional and does not take an argument.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help

pub fn optflagmulti(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str
) -> &mut Options
[src]

Create a long option that can occur more than once and does not take an argument.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help

pub fn optflagopt(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str,
    hint: &str
) -> &mut Options
[src]

Create a long option that is optional and takes an optional argument.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help
  • hint - Hint that is used in place of the argument in the usage help, e.g. "FILE" for a -o FILE option

pub fn optmulti(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str,
    hint: &str
) -> &mut Options
[src]

Create a long option that is optional, takes an argument, and may occur multiple times.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help
  • hint - Hint that is used in place of the argument in the usage help, e.g. "FILE" for a -o FILE option

pub fn optopt(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str,
    hint: &str
) -> &mut Options
[src]

Create a long option that is optional and takes an argument.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help
  • hint - Hint that is used in place of the argument in the usage help, e.g. "FILE" for a -o FILE option

pub fn reqopt(
    &mut self,
    short_name: &str,
    long_name: &str,
    desc: &str,
    hint: &str
) -> &mut Options
[src]

Create a long option that is required and takes an argument.

  • short_name - e.g. "h" for a -h option, or "" for none
  • long_name - e.g. "help" for a --help option, or "" for none
  • desc - Description for usage help
  • hint - Hint that is used in place of the argument in the usage help, e.g. "FILE" for a -o FILE option

pub fn parse<C: IntoIterator>(&self, args: C) -> Result where
    C::Item: AsRef<OsStr>, 
[src]

Parse command line arguments according to the provided options.

On success returns Ok(Matches). Use methods such as opt_present opt_str, etc. to interrogate results.

Panics

Returns Err(Fail) on failure: use the Debug implementation of Fail to display information about it.

pub fn short_usage(&self, program_name: &str) -> String[src]

Derive a short one-line usage summary from a set of long options.

pub fn usage(&self, brief: &str) -> String[src]

Derive a formatted message from a set of options.

pub fn usage_with_format<F: FnMut(&mut dyn Iterator<Item = String>) -> String>(
    &self,
    formatter: F
) -> String
[src]

Derive a custom formatted message from a set of options. The formatted options provided to a closure as an iterator.

Trait Implementations

impl Default for Options[src]

Auto Trait Implementations

impl Unpin for Options

impl Send for Options

impl Sync for Options

impl RefUnwindSafe for Options

impl UnwindSafe for Options

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]