Struct RangeFull

pub struct RangeFull;

An unbounded range (..).

RangeFull is primarily used as a slicing index, its shorthand is ... It cannot serve as an Iterator because it doesn’t have a starting point.

Examples

The .. syntax is a RangeFull:

assert_eq!(.., std::ops::RangeFull);

It does not have an IntoIterator implementation, so you can’t use it in a for loop directly. This won’t compile:

for i in .. {
    // ...
}

Used as a slicing index, RangeFull produces the full array as a slice.

let arr = [0, 1, 2, 3, 4];
assert_eq!(arr[ ..  ], [0, 1, 2, 3, 4]); // This is the `RangeFull`
assert_eq!(arr[ .. 3], [0, 1, 2      ]);
assert_eq!(arr[ ..=3], [0, 1, 2, 3   ]);
assert_eq!(arr[1..  ], [   1, 2, 3, 4]);
assert_eq!(arr[1.. 3], [   1, 2      ]);
assert_eq!(arr[1..=3], [   1, 2, 3   ]);

Trait Implementations

impl Arbitrary for RangeFull

type Parameters = ()

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = Just<RangeFull>

The type of Strategy used to generate values of type Self.

fn arbitrary_with( _args: <RangeFull as Arbitrary>::Parameters, ) -> <RangeFull as Arbitrary>::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for RangeFull

fn clone(&self) -> RangeFull

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C1> ContainsToken<C1> for RangeFull

where C1: AsChar,

fn contains_token(&self, _token: C1) -> bool

Returns true if self contains the token

impl Debug for RangeFull

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

Formats the value using the given formatter.

impl Default for RangeFull

fn default() -> RangeFull

Returns the “default value” for a type.

impl From<RangeFull> for Range

fn from(_: RangeFull) -> Range

Converts to this type from the input type.

impl From<RangeFull> for ValueParser

Create an i64 ValueParser from a .. range

See RangedI64ValueParser for more control over the output type.

See also RangedU64ValueParser

Examples

let mut cmd = clap::Command::new("raw")
    .arg(
        clap::Arg::new("port")
            .long("port")
            .value_parser(..)
            .action(clap::ArgAction::Set)
            .required(true)
    );

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

fn from(value: RangeFull) -> ValueParser

Converts to this type from the input type.

impl From<RangeFull> for ValueRange

fn from(_: RangeFull) -> ValueRange

Converts to this type from the input type.

impl Hash for RangeFull

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

where __H: Hasher,

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 Index<RangeFull> for BStr

type Output = BStr

The returned type after indexing.

fn index(&self, _: RangeFull) -> &BStr

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for BStr

type Output = BStr

The returned type after indexing.

fn index(&self, _: RangeFull) -> &BStr

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for Bytes

type Output = Bytes

The returned type after indexing.

fn index(&self, _: RangeFull) -> &Bytes

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for CString

type Output = CStr

The returned type after indexing.

fn index(&self, _index: RangeFull) -> &CStr

Performs the indexing (container[index]) operation.

impl<K, V, S> Index<RangeFull> for IndexMap<K, V, S>

type Output = Slice<K, V>

The returned type after indexing.

fn index( &self, range: RangeFull, ) -> &<IndexMap<K, V, S> as Index<RangeFull>>::Output

Performs the indexing (container[index]) operation.

impl<T, S> Index<RangeFull> for IndexSet<T, S>

type Output = Slice<T>

The returned type after indexing.

fn index( &self, range: RangeFull, ) -> &<IndexSet<T, S> as Index<RangeFull>>::Output

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for OsString

type Output = OsStr

The returned type after indexing.

fn index(&self, _index: RangeFull) -> &OsStr

Performs the indexing (container[index]) operation.

impl<K, V> Index<RangeFull> for Slice<K, V>

type Output = Slice<K, V>

The returned type after indexing.

fn index(&self, range: RangeFull) -> &Slice<K, V>

Performs the indexing (container[index]) operation.

impl<T> Index<RangeFull> for Slice<T>

type Output = Slice<T>

The returned type after indexing.

fn index(&self, range: RangeFull) -> &<Slice<T> as Index<RangeFull>>::Output

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for UninitSlice

type Output = UninitSlice

The returned type after indexing.

fn index(&self, index: RangeFull) -> &UninitSlice

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for Url

type Output = str

The returned type after indexing.

fn index(&self, _: RangeFull) -> &str

Performs the indexing (container[index]) operation.

impl IndexMut<RangeFull> for BStr

fn index_mut(&mut self, _: RangeFull) -> &mut BStr

Performs the mutable indexing (container[index]) operation.

impl<K, V, S> IndexMut<RangeFull> for IndexMap<K, V, S>

fn index_mut( &mut self, range: RangeFull, ) -> &mut <IndexMap<K, V, S> as Index<RangeFull>>::Output

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeFull> for OsString

fn index_mut(&mut self, _index: RangeFull) -> &mut OsStr

Performs the mutable indexing (container[index]) operation.

impl<K, V> IndexMut<RangeFull> for Slice<K, V>

fn index_mut(&mut self, range: RangeFull) -> &mut Slice<K, V>

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeFull> for UninitSlice

fn index_mut(&mut self, index: RangeFull) -> &mut UninitSlice

Performs the mutable indexing (container[index]) operation.

impl<I> IteratorIndex<I> for RangeFull

where I: Iterator,

type Output = I

The type returned for this type of index.

fn index(self, iter: I) -> <RangeFull as IteratorIndex<I>>::Output

Returns an adapted iterator for the current index.

impl<I> IteratorIndex<I> for RangeFull

where I: Iterator,

type Output = I

The type returned for this type of index.

fn index(self, iter: I) -> <RangeFull as IteratorIndex<I>>::Output

Returns an adapted iterator for the current index.

impl NomRange<usize> for RangeFull

type Saturating = SaturatingIterator

The saturating iterator type.

type Bounded = Range<usize>

The bounded iterator type.

fn bounds(&self) -> (Bound<usize>, Bound<usize>)

Returns the bounds of this range.

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

true if item is contained in the range.

fn is_inverted(&self) -> bool

true if the range is inverted.

fn saturating_iter(&self) -> <RangeFull as NomRange<usize>>::Saturating

Creates a saturating iterator. A saturating iterator counts the number of iterations starting from 0 up to the upper bound of this range. If the upper bound is infinite the iterator saturates at the largest representable value of its type and returns it for all further elements.

fn bounded_iter(&self) -> <RangeFull as NomRange<usize>>::Bounded

Creates a bounded iterator. A bounded iterator counts the number of iterations starting from 0 up to the upper bound of this range. If the upper bounds is infinite the iterator counts up until the amount of iterations has reached the largest representable value of its type and then returns None for all further elements.

impl PartialEq for RangeFull

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> RangeBounds<T> for RangeFull

where T: ?Sized,

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

Start index bound.

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

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.

impl<'a, T> Slice<RangeFull> for &'a [T]

fn slice(&self, range: RangeFull) -> &'a [T]

Slices self according to the range argument

impl<'a> Slice<RangeFull> for &'a str

fn slice(&self, range: RangeFull) -> &'a str

Slices self according to the range argument

impl<T> SliceIndex<[T]> for RangeFull

type Output = [T]

The output type returned by methods.

fn get(self, slice: &[T]) -> Option<&[T]>

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

Returns a shared reference to the output at this location, if in bounds.

fn get_mut(self, slice: &mut [T]) -> Option<&mut [T]>

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

Returns a mutable reference to the output at this location, if in bounds.

unsafe fn get_unchecked(self, slice: *const [T]) -> *const [T]

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

Returns a pointer to the output at this location, without performing any bounds checking.

unsafe fn get_unchecked_mut(self, slice: *mut [T]) -> *mut [T]

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

Returns a mutable pointer to the output at this location, without performing any bounds checking.

fn index(self, slice: &[T]) -> &[T]

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

Returns a shared reference to the output at this location, panicking if out of bounds.

fn index_mut(self, slice: &mut [T]) -> &mut [T]

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

Returns a mutable reference to the output at this location, panicking if out of bounds.

impl SliceIndex<str> for RangeFull

Implements substring slicing with syntax &self[..] or &mut self[..].

Returns a slice of the whole string, i.e., returns &self or &mut self. Equivalent to &self[0 .. len] or &mut self[0 .. len]. Unlike other indexing operations, this can never panic.

This operation is O(1).

Prior to 1.20.0, these indexing operations were still supported by direct implementation of Index and IndexMut.

Equivalent to &self[0 .. len] or &mut self[0 .. len].

type Output = str

The output type returned by methods.

fn get(self, slice: &str) -> Option<&<RangeFull as SliceIndex<str>>::Output>

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

Returns a shared reference to the output at this location, if in bounds.

fn get_mut( self, slice: &mut str, ) -> Option<&mut <RangeFull as SliceIndex<str>>::Output>

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

Returns a mutable reference to the output at this location, if in bounds.

unsafe fn get_unchecked( self, slice: *const str, ) -> *const <RangeFull as SliceIndex<str>>::Output

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

Returns a pointer to the output at this location, without performing any bounds checking.

unsafe fn get_unchecked_mut( self, slice: *mut str, ) -> *mut <RangeFull as SliceIndex<str>>::Output

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

Returns a mutable pointer to the output at this location, without performing any bounds checking.

fn index(self, slice: &str) -> &<RangeFull as SliceIndex<str>>::Output

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

Returns a shared reference to the output at this location, panicking if out of bounds.

fn index_mut( self, slice: &mut str, ) -> &mut <RangeFull as SliceIndex<str>>::Output

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

Returns a mutable reference to the output at this location, panicking if out of bounds.

impl<'data> TryFrom<&RangeFull> for CodePointInversionList<'data>

type Error = CodePointInversionListError

The type returned in the event of a conversion error.

fn try_from( _: &RangeFull, ) -> Result<CodePointInversionList<'data>, <CodePointInversionList<'data> as TryFrom<&RangeFull>>::Error>

Performs the conversion.

impl Copy for RangeFull

impl Eq for RangeFull

impl StructuralPartialEq for RangeFull