Struct `RangedI64ValueParser`

struct RangedI64ValueParser<T: TryFrom<i64> + Clone + Send + Sync = i64> { ... }

Parse number that fall within a range of values

NOTE: To capture negative values, you will also need to set [Arg::allow_negative_numbers][crate::Arg::allow_negative_numbers] or [Arg::allow_hyphen_values][crate::Arg::allow_hyphen_values].

Example

Usage:

# use clap_builder as clap;
let mut cmd = clap::Command::new("raw")
    .arg(
        clap::Arg::new("port")
            .long("port")
            .value_parser(clap::value_parser!(u16).range(3000..))
            .action(clap::ArgAction::Set)
            .required(true)
    );

let m = cmd.try_get_matches_from_mut(["cmd", "--port", "3001"]).unwrap();
let port: u16 = *m.get_one("port")
    .expect("required");
assert_eq!(port, 3001);

Semantics:

# use clap_builder as clap;
# use std::ffi::OsStr;
# use clap::builder::TypedValueParser;
# let cmd = clap::Command::new("test");
# let arg = None;
let value_parser = clap::builder::RangedI64ValueParser::<i32>::new().range(-1..200);
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("random")).is_err());
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("")).is_err());
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("-200")).is_err());
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("300")).is_err());
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("-1")).unwrap(), -1);
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("0")).unwrap(), 0);
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("50")).unwrap(), 50);

Implementations

`impl<T: TryFrom<i64> + Clone + Send + Sync> RangedI64ValueParser<T>`

fn new() -> Self: Select full range of i64
fn range<B: RangeBounds<i64>>(self: Self, range: B) -> Self: Narrow the supported range

`impl<I> IntoResettable for RangedI64ValueParser<T>`

fn into_resettable(self: Self) -> Resettable<ValueParser>

`impl<T> Any for RangedI64ValueParser<T>`

fn type_id(self: &Self) -> TypeId

`impl<T> Borrow for RangedI64ValueParser<T>`

fn borrow(self: &Self) -> &T

`impl<T> BorrowMut for RangedI64ValueParser<T>`

fn borrow_mut(self: &mut Self) -> &mut T

`impl<T> CloneToUninit for RangedI64ValueParser<T>`

unsafe fn clone_to_uninit(self: &Self, dest: *mut u8)

`impl<T> Freeze for RangedI64ValueParser<T>`

`impl<T> From for RangedI64ValueParser<T>`

fn from(t: T) -> T: Returns the argument unchanged.

`impl<T> RefUnwindSafe for RangedI64ValueParser<T>`

`impl<T> Send for RangedI64ValueParser<T>`

`impl<T> Sync for RangedI64ValueParser<T>`

`impl<T> ToOwned for RangedI64ValueParser<T>`

fn to_owned(self: &Self) -> T
fn clone_into(self: &Self, target: &mut T)

`impl<T> Unpin for RangedI64ValueParser<T>`

`impl<T> UnsafeUnpin for RangedI64ValueParser<T>`

`impl<T> UnwindSafe for RangedI64ValueParser<T>`

`impl<T, U> Into for RangedI64ValueParser<T>`

fn into(self: Self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

`impl<T, U> TryFrom for RangedI64ValueParser<T>`

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

`impl<T, U> TryInto for RangedI64ValueParser<T>`

fn try_into(self: Self) -> Result<U, <U as TryFrom<T>>::Error>

`impl<T: $crate::clone::Clone + TryFrom<i64> + Clone + Send + Sync> Clone for RangedI64ValueParser<T>`

fn clone(self: &Self) -> RangedI64ValueParser<T>

`impl<T: $crate::fmt::Debug + TryFrom<i64> + Clone + Send + Sync> Debug for RangedI64ValueParser<T>`

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

`impl<T: $crate::marker::Copy + TryFrom<i64> + Clone + Send + Sync> Copy for RangedI64ValueParser<T>`

`impl<T: TryFrom<i64> + Clone + Send + Sync + 'static> TypedValueParser for RangedI64ValueParser<T>`

fn parse_ref(self: &Self, cmd: &Command, arg: Option<&Arg>, raw_value: &OsStr) -> Result<<Self as >::Value, Error>

`impl<T: TryFrom<i64> + Clone + Send + Sync> Default for RangedI64ValueParser<T>`

fn default() -> Self

`impl<T: TryFrom<i64> + Clone + Send + Sync, B: RangeBounds<i64>> From for RangedI64ValueParser<T>`

fn from(range: B) -> Self