Struct ValueRange 

pub struct ValueRange { /* private fields */ }

Values per occurrence for an argument

Implementations

impl ValueRange

pub const EMPTY: Self

Nor argument values, or a flag

pub const SINGLE: Self

A single argument value, the most common case for options

pub fn new(range: impl Into<Self>) -> Self

Create a range

Panics

In debug builds, if the range accepts no values. For an exclusive range (start..end) that means end must be greater than start, so both reversed ranges like 10..5 and empty ranges like 5..5 panic.

Examples

let range = ValueRange::new(5);
let range = ValueRange::new(5..10);
let range = ValueRange::new(5..=10);
let range = ValueRange::new(5..);
let range = ValueRange::new(..10);
let range = ValueRange::new(..=10);

While these will panic:

let range = ValueRange::new(10..5);  // Panics! (reversed)

let range = ValueRange::new(5..5);  // Panics! (empty)

pub fn min_values(&self) -> usize

Fewest number of values the argument accepts

pub fn max_values(&self) -> usize

Most number of values the argument accepts

pub fn takes_values(&self) -> bool

Report whether the argument takes any values (ie is a flag)

Examples

let range = ValueRange::new(5);
assert!(range.takes_values());

let range = ValueRange::new(0);
assert!(!range.takes_values());

Trait Implementations

impl Clone for ValueRange

fn clone(&self) -> ValueRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ValueRange

impl Debug for ValueRange

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

Formats the value using the given formatter.

impl Default for ValueRange

fn default() -> Self

Returns the “default value” for a type.

impl Display for ValueRange

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

Formats the value using the given formatter.

impl Eq for ValueRange

impl From<Range<usize>> for ValueRange

fn from(range: Range<usize>) -> Self

Converts to this type from the input type.

impl From<RangeFrom<usize>> for ValueRange

fn from(range: RangeFrom<usize>) -> Self

Converts to this type from the input type.

impl From<RangeFull> for ValueRange

fn from(_: RangeFull) -> Self

Converts to this type from the input type.

impl From<RangeInclusive<usize>> for ValueRange

fn from(range: RangeInclusive<usize>) -> Self

Converts to this type from the input type.

impl From<RangeTo<usize>> for ValueRange

fn from(range: RangeTo<usize>) -> Self

Converts to this type from the input type.

impl From<RangeToInclusive<usize>> for ValueRange

fn from(range: RangeToInclusive<usize>) -> Self

Converts to this type from the input type.

impl From<usize> for ValueRange

fn from(fixed: usize) -> Self

Converts to this type from the input type.

impl Hash for ValueRange

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ValueRange

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

Equality operator ==.

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

Inequality operator !=.

impl RangeBounds<usize> for ValueRange

fn start_bound(&self) -> Bound<&usize>

Start index bound.

fn end_bound(&self) -> Bound<&usize>

End index bound.

fn contains<U>(&self, item: &U) -> bool

where T: PartialOrd<U>, U: PartialOrd<T> + ?Sized,

Returns true if item is contained in the range.

fn is_empty(&self) -> bool

where T: PartialOrd,

🔬This is a nightly-only experimental API. (range_bounds_is_empty)

Returns true if the range contains no items. One-sided ranges (RangeFrom, etc) always return false.

impl StructuralPartialEq for ValueRange