Struct std::ops::RangeToInclusive 1.26.0[−][src]
pub struct RangeToInclusive<Idx> {
pub end: Idx,
}Expand description
A range only bounded inclusively above (..=end).
The RangeToInclusive ..=end contains all values with x <= end.
It cannot serve as an Iterator because it doesn’t have a starting point.
Examples
The ..=end syntax is a RangeToInclusive:
assert_eq!((..=5), std::ops::RangeToInclusive{ end: 5 });RunIt does not have an IntoIterator implementation, so you can’t use it in a
for loop directly. This won’t compile:
// error[E0277]: the trait bound `std::ops::RangeToInclusive<{integer}>:
// std::iter::Iterator` is not satisfied
for i in ..=5 {
// ...
}RunWhen used as a slicing index, RangeToInclusive produces a slice of all
array elements up to and including the index indicated by end.
let arr = [0, 1, 2, 3, 4];
assert_eq!(arr[ .. ], [0, 1, 2, 3, 4]);
assert_eq!(arr[ .. 3], [0, 1, 2 ]);
assert_eq!(arr[ ..=3], [0, 1, 2, 3 ]); // This is a `RangeToInclusive`
assert_eq!(arr[1.. ], [ 1, 2, 3, 4]);
assert_eq!(arr[1.. 3], [ 1, 2 ]);
assert_eq!(arr[1..=3], [ 1, 2, 3 ]);RunFields
end: IdxThe upper bound of the range (inclusive)
Implementations
1.35.0[src]pub fn contains<U>(&self, item: &U) -> bool where
U: PartialOrd<Idx> + ?Sized,
Idx: PartialOrd<U>,
pub fn contains<U>(&self, item: &U) -> bool where
U: PartialOrd<Idx> + ?Sized,
Idx: PartialOrd<U>,
Trait Implementations
impl<Idx> PartialEq<RangeToInclusive<Idx>> for RangeToInclusive<Idx> where
Idx: PartialEq<Idx>,
impl<Idx> PartialEq<RangeToInclusive<Idx>> for RangeToInclusive<Idx> where
Idx: PartialEq<Idx>,
This method tests for self and other values to be equal, and is used
by ==. Read more
This method tests for !=.
slice_index_methods)Returns a shared reference to the output at this location, if in bounds. Read more
slice_index_methods)Returns a mutable reference to the output at this location, if in bounds. Read more
slice_index_methods)Returns a shared reference to the output at this location, without
performing any bounds checking.
Calling this method with an out-of-bounds index or a dangling slice pointer
is undefined behavior even if the resulting reference is not used. Read more
slice_index_methods)Returns a mutable reference to the output at this location, without
performing any bounds checking.
Calling this method with an out-of-bounds index or a dangling slice pointer
is undefined behavior even if the resulting reference is not used. Read more
slice_index_methods)Returns a shared reference to the output at this location, panicking if out of bounds. Read more
Implements substring slicing with syntax &self[..= end] or &mut self[..= end].
Returns a slice of the given string from the byte range [0, end].
Equivalent to &self [0 .. end + 1], except if end has the maximum
value for usize.
This operation is O(1).
Panics
Panics if end does not point to the ending byte offset of a character
(end + 1 is either a starting byte offset as defined by
is_char_boundary, or equal to len), or if end >= len.
pub fn get(
self,
slice: &str
) -> Option<&<RangeToInclusive<usize> as SliceIndex<str>>::Output>
pub fn get(
self,
slice: &str
) -> Option<&<RangeToInclusive<usize> as SliceIndex<str>>::Output>
slice_index_methods)Returns a shared reference to the output at this location, if in bounds. Read more
pub fn get_mut(
self,
slice: &mut str
) -> Option<&mut <RangeToInclusive<usize> as SliceIndex<str>>::Output>
pub fn get_mut(
self,
slice: &mut str
) -> Option<&mut <RangeToInclusive<usize> as SliceIndex<str>>::Output>
slice_index_methods)Returns a mutable reference to the output at this location, if in bounds. Read more
pub unsafe fn get_unchecked(
self,
slice: *const str
) -> *const <RangeToInclusive<usize> as SliceIndex<str>>::Output
pub unsafe fn get_unchecked(
self,
slice: *const str
) -> *const <RangeToInclusive<usize> as SliceIndex<str>>::Output
slice_index_methods)Returns a shared reference to the output at this location, without
performing any bounds checking.
Calling this method with an out-of-bounds index or a dangling slice pointer
is undefined behavior even if the resulting reference is not used. Read more
pub unsafe fn get_unchecked_mut(
self,
slice: *mut str
) -> *mut <RangeToInclusive<usize> as SliceIndex<str>>::Output
pub unsafe fn get_unchecked_mut(
self,
slice: *mut str
) -> *mut <RangeToInclusive<usize> as SliceIndex<str>>::Output
slice_index_methods)Returns a mutable reference to the output at this location, without
performing any bounds checking.
Calling this method with an out-of-bounds index or a dangling slice pointer
is undefined behavior even if the resulting reference is not used. Read more
slice_index_methods)Returns a shared reference to the output at this location, panicking if out of bounds. Read more
pub fn index_mut(
self,
slice: &mut str
) -> &mut <RangeToInclusive<usize> as SliceIndex<str>>::Output
pub fn index_mut(
self,
slice: &mut str
) -> &mut <RangeToInclusive<usize> as SliceIndex<str>>::Output
slice_index_methods)Returns a mutable reference to the output at this location, panicking if out of bounds. Read more
Auto Trait Implementations
impl<Idx> RefUnwindSafe for RangeToInclusive<Idx> where
Idx: RefUnwindSafe,
impl<Idx> Send for RangeToInclusive<Idx> where
Idx: Send,
impl<Idx> Sync for RangeToInclusive<Idx> where
Idx: Sync,
impl<Idx> Unpin for RangeToInclusive<Idx> where
Idx: Unpin,
impl<Idx> UnwindSafe for RangeToInclusive<Idx> where
Idx: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more