logo
pub trait ArgEnum: Sized + Clone {
    fn value_variants<'a>() -> &'a [Self]Notable traits for &'_ [u8]impl<'_> Read for &'_ [u8]impl<'_> Write for &'_ mut [u8];
    fn to_possible_value<'a>(&self) -> Option<PossibleValue<'a>>;

    fn from_str(input: &str, ignore_case: bool) -> Result<Self, String> { ... }
}
Expand description

Parse arguments into enums.

When deriving Parser, a field whose type implements ValueEnum can have the attribute #[clap(value_enum)] which will

  • Call Arg::possible_values
  • Allowing using the #[clap(default_value_t)] attribute without implementing Display.

See the derive reference for attributes and best practices.

NOTE: Deriving requires the [derive feature flag][crate::_features]

Example

#[derive(clap::Parser)]
struct Args {
   #[clap(value_enum)]
   level: Level,
}

#[derive(clap::ValueEnum, Clone)]
enum Level {
   Debug,
   Info,
   Warning,
   Error,
}

Required methods

All possible argument values, in display order.

The canonical argument value.

The value is None for skipped variants.

Provided methods

Parse an argument into Self.

Implementors