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 Clone for RangeFull

fn clone(&self) -> RangeFull

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 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 ByteString

type Output = ByteStr

The returned type after indexing.

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

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 ByteString

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

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<T> IntoBounds<T> for RangeFull

fn into_bounds(self) -> (Bound<T>, Bound<T>)

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

Convert this range into the start and end bounds. Returns (start_bound, end_bound).

fn intersect<R>(self, other: R) -> (Bound<T>, Bound<T>)

where Self: Sized, T: Ord, R: IntoBounds<T>,

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

Compute the intersection of self and other.

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.

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<'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<ByteStr> for RangeFull

type Output = ByteStr

The output type returned by methods.

fn get( self, slice: &ByteStr, ) -> Option<&<RangeFull as SliceIndex<ByteStr>>::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 ByteStr, ) -> Option<&mut <RangeFull as SliceIndex<ByteStr>>::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 ByteStr, ) -> *const <RangeFull as SliceIndex<ByteStr>>::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 ByteStr, ) -> *mut <RangeFull as SliceIndex<ByteStr>>::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: &ByteStr) -> &<RangeFull as SliceIndex<ByteStr>>::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 ByteStr, ) -> &mut <RangeFull as SliceIndex<ByteStr>>::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 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 Copy for RangeFull

impl Eq for RangeFull

impl StructuralPartialEq for RangeFull