std::ops::RangeFull - Rust
Description: API documentation for the Rust `RangeFull` struct in crate `std`.
Keywords: rust, rustlang, rust-lang, RangeFull

# Struct std::ops::RangeFull 1.0.0[−][src]

    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);Run

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

ⓘThis example deliberately fails to compile

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

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

    let arr = [0, 1, 2, 3];
    assert_eq!(arr[ .. ], [0,1,2,3]);  // RangeFull
    assert_eq!(arr[ ..3], [0,1,2  ]);
    assert_eq!(arr[1.. ], [  1,2,3]);
    assert_eq!(arr[1..3], [  1,2  ]);Run

## Trait Implementations

###

`impl<T> RangeBounds<T> for RangeFull where T: ?Sized,`

1.28.0
[src]

####

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

[src]

Start index bound. Read more

####

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

[src]

End index bound. Read more

####

`fn contains<U>(&self, item: &U) -> bool where T: PartialOrd<U>, U: PartialOrd<T> + ?Sized,`

[src]

🔬 This is a nightly-only experimental API. (`range_contains` #32311)

recently added as per RFC

Returns `true` if `item` is contained in the range. Read more

###

`impl Hash for RangeFull`

[src]

####

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

[src]

Feeds this value into the given [`Hasher`]. Read more

####

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

1.3.0
[src]

Feeds a slice of this type into the given [`Hasher`]. Read more

###

`impl Clone for RangeFull`

[src]

####

`fn clone(&self) -> RangeFull`

[src]

Returns a copy of the value. Read more

####

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

[src]

Performs copy-assignment from `source`. Read more

###

`impl Debug for RangeFull`

[src]

####

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

[src]

Formats the value using the given formatter. Read more

###

`impl IndexMut<RangeFull> for str`

1.3.0
[src]

Implements mutable substring slicing with syntax `&mut self[..]`.

Returns a mutable slice of the whole string. This operation can never panic.

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

####

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

[src]

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

###

`impl Index<RangeFull> for str`

[src]

Implements substring slicing with syntax `&self[..]`.

Returns a slice of the whole string. This operation can never panic.

Equivalent to `&self[0 .. len]`.

#### `type Output = str`

The returned type after indexing.

####

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

[src]

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

###

`impl SliceIndex<str> for RangeFull`

1.20.0
[src]

#### `type Output = str`

The output type returned by methods.

####

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

[src]

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

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

####

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

[src]

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

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

####

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

[src]

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

Returns a shared reference to the output at this location, without performing any bounds checking. Read more

####

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

[src]

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

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

####

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

[src]

🔬 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. Read more

####

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

[src]

🔬 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. Read more

###

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

1.15.0
[src]

#### `type Output = [T]`

The output type returned by methods.

####

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

[src]

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

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

####

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

[src]

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

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

####
ⓘImportant traits for &'a [u8]

### Important traits for &'a [u8]

`impl<'a> Read for &'a [u8]impl<'a> Write for &'a mut [u8]`

`unsafe fn get_unchecked(self, slice: &[T]) -> &[T]`

[src]

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

Returns a shared reference to the output at this location, without performing any bounds checking. Read more

####
ⓘImportant traits for &'a [u8]

### Important traits for &'a [u8]

`impl<'a> Read for &'a [u8]impl<'a> Write for &'a mut [u8]`

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

[src]

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

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

####
ⓘImportant traits for &'a [u8]

### Important traits for &'a [u8]

`impl<'a> Read for &'a [u8]impl<'a> Write for &'a mut [u8]`

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

[src]

🔬 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. Read more

####
ⓘImportant traits for &'a [u8]

### Important traits for &'a [u8]

`impl<'a> Read for &'a [u8]impl<'a> Write for &'a mut [u8]`

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

[src]

🔬 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. Read more

###

`impl Eq for RangeFull`

[src]

###

`impl PartialEq<RangeFull> for RangeFull`

[src]

####

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

[src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

####

`#[must_use] fn ne(&self, other: &Rhs) -> bool`

[src]

This method tests for `!=`.

###

`impl Copy for RangeFull`

[src]

###

`impl Index<RangeFull> for String`

[src]

#### `type Output = str`

The returned type after indexing.

####

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

[src]

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

###

`impl IndexMut<RangeFull> for String`

1.3.0
[src]

####

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

[src]

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

###

`impl Index<RangeFull> for CString`

1.7.0
[src]

#### `type Output = CStr`

The returned type after indexing.

####

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

[src]

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

###

`impl Index<RangeFull> for OsString`

[src]

#### `type Output = OsStr`

The returned type after indexing.

####

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

[src]

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

## Auto Trait Implementations

###

`impl Send for RangeFull`

###

`impl Sync for RangeFull`

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)