lynx   »   [go: up one dir, main page]
std::range

Struct RangeFrom

Source 
pub struct RangeFrom<Idx> {
    pub start: Idx,
}
๐Ÿ”ฌThis is a nightly-only experimental API. (new_range_api #125687)
Expand description

A range only bounded inclusively below (start..).

The RangeFrom start.. contains all values with x >= start.

Note: Overflow in the Iterator implementation (when the contained data type reaches its numerical limit) is allowed to panic, wrap, or saturate. This behavior is defined by the implementation of the Step trait. For primitive integers, this follows the normal rules, and respects the overflow checks profile (panic in debug, wrap in release). Note also that overflow happens earlier than you might assume: the overflow happens in the call to next that yields the maximum value, as the range must be set to a state to yield the next value.

ยงExamples

The start.. syntax is a RangeFrom:

#![feature(new_range_api)]
use core::range::RangeFrom;

assert_eq!(RangeFrom::from(2..), core::range::RangeFrom { start: 2 });
assert_eq!(2 + 3 + 4, RangeFrom::from(2..).into_iter().take(3).sum());

Fieldsยง

ยงstart: Idx
๐Ÿ”ฌThis is a nightly-only experimental API. (new_range_api #125687)

The lower bound of the range (inclusive).

Implementationsยง

Sourceยง

impl<Idx> RangeFrom<Idx>
where Idx: Step,

Source

pub fn iter(&self) -> IterRangeFrom<Idx> โ“˜

๐Ÿ”ฌThis is a nightly-only experimental API. (new_range_api #125687)

Creates an iterator over the elements within this range.

Shorthand for .clone().into_iter()

ยงExamples
#![feature(new_range_api)]
use core::range::RangeFrom;

let mut i = RangeFrom::from(3..).iter().map(|n| n*n);
assert_eq!(i.next(), Some(9));
assert_eq!(i.next(), Some(16));
assert_eq!(i.next(), Some(25));
Sourceยง

impl<Idx> RangeFrom<Idx>
where Idx: PartialOrd,

Source

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

๐Ÿ”ฌThis is a nightly-only experimental API. (new_range_api #125687)

Returns true if item is contained in the range.

ยงExamples
#![feature(new_range_api)]
use core::range::RangeFrom;

assert!(!RangeFrom::from(3..).contains(&2));
assert!( RangeFrom::from(3..).contains(&3));
assert!( RangeFrom::from(3..).contains(&1_000_000_000));

assert!( RangeFrom::from(0.0..).contains(&0.5));
assert!(!RangeFrom::from(0.0..).contains(&f32::NAN));
assert!(!RangeFrom::from(f32::NAN..).contains(&0.5));

Trait Implementationsยง

Sourceยง

impl<Idx> Clone for RangeFrom<Idx>
where Idx: Clone,

Sourceยง

fn clone(&self) -> RangeFrom<Idx>

Returns a copy of the value. Read more
1.0.0 ยท Sourceยง

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

Performs copy-assignment from source. Read more
Sourceยง

impl<Idx> Debug for RangeFrom<Idx>
where Idx: Debug,

Sourceยง

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

Formats the value using the given formatter. Read more
Sourceยง

impl<T> From<RangeFrom<T>> for RangeFrom<T>

Sourceยง

fn from(value: RangeFrom<T>) -> RangeFrom<T> โ“˜

Converts to this type from the input type.
Sourceยง

impl<T> From<RangeFrom<T>> for RangeFrom<T>

Sourceยง

fn from(value: RangeFrom<T>) -> RangeFrom<T>

Converts to this type from the input type.
Sourceยง

impl<Idx> Hash for RangeFrom<Idx>
where Idx: Hash,

Sourceยง

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

Feeds this value into the given Hasher. Read more
1.3.0 ยท Sourceยง

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

Feeds a slice of this type into the given Hasher. Read more
Sourceยง

impl<T> IntoBounds<T> for RangeFrom<T>

Sourceยง

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

๐Ÿ”ฌThis is a nightly-only experimental API. (range_into_bounds #136903)
Convert this range into the start and end bounds. Returns (start_bound, end_bound). Read more
Sourceยง

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 #136903)
Compute the intersection of self and other. Read more
Sourceยง

impl<A> IntoIterator for RangeFrom<A>
where A: Step,

Sourceยง

type Item = A

The type of the elements being iterated over.
Sourceยง

type IntoIter = IterRangeFrom<A>

Which kind of iterator are we turning this into?
Sourceยง

fn into_iter(self) -> <RangeFrom<A> as IntoIterator>::IntoIter

Creates an iterator from a value. Read more
Sourceยง

impl<Idx> PartialEq for RangeFrom<Idx>
where Idx: PartialEq,

Sourceยง

fn eq(&self, other: &RangeFrom<Idx>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 ยท Sourceยง

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

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

impl<T> RangeBounds<T> for RangeFrom<&T>

Sourceยง

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

Start index bound. Read more
Sourceยง

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

End index bound. Read more
1.35.0 ยท Sourceยง

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

Returns true if item is contained in the range. Read more
Sourceยง

fn is_empty(&self) -> bool
where T: PartialOrd,

๐Ÿ”ฌThis is a nightly-only experimental API. (range_bounds_is_empty #137300)
Returns true if the range contains no items. One-sided ranges (RangeFrom, etc) always return false. Read more
Sourceยง

impl<T> RangeBounds<T> for RangeFrom<T>

Sourceยง

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

Start index bound. Read more
Sourceยง

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

End index bound. Read more
1.35.0 ยท Sourceยง

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

Returns true if item is contained in the range. Read more
Sourceยง

fn is_empty(&self) -> bool
where T: PartialOrd,

๐Ÿ”ฌThis is a nightly-only experimental API. (range_bounds_is_empty #137300)
Returns true if the range contains no items. One-sided ranges (RangeFrom, etc) always return false. Read more
Sourceยง

impl<T> SliceIndex<[T]> for RangeFrom<usize>

Sourceยง

type Output = [T]

The output type returned by methods.
Sourceยง

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.
Sourceยง

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.
Sourceยง

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. Read more
Sourceยง

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. Read more
Sourceยง

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.
Sourceยง

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.
Sourceยง

impl SliceIndex<str> for RangeFrom<usize>

Sourceยง

type Output = str

The output type returned by methods.
Sourceยง

fn get( self, slice: &str, ) -> Option<&<RangeFrom<usize> 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.
Sourceยง

fn get_mut( self, slice: &mut str, ) -> Option<&mut <RangeFrom<usize> 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.
Sourceยง

unsafe fn get_unchecked( self, slice: *const str, ) -> *const <RangeFrom<usize> 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. Read more
Sourceยง

unsafe fn get_unchecked_mut( self, slice: *mut str, ) -> *mut <RangeFrom<usize> 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. Read more
Sourceยง

fn index(self, slice: &str) -> &<RangeFrom<usize> 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.
Sourceยง

fn index_mut( self, slice: &mut str, ) -> &mut <RangeFrom<usize> 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.
Sourceยง

impl<Idx> Copy for RangeFrom<Idx>
where Idx: Copy,

Sourceยง

impl<Idx> Eq for RangeFrom<Idx>
where Idx: Eq,

Sourceยง

impl<Idx> StructuralPartialEq for RangeFrom<Idx>

Auto Trait Implementationsยง

ยง

impl<Idx> Freeze for RangeFrom<Idx>
where Idx: Freeze,

ยง

impl<Idx> RefUnwindSafe for RangeFrom<Idx>
where Idx: RefUnwindSafe,

ยง

impl<Idx> Send for RangeFrom<Idx>
where Idx: Send,

ยง

impl<Idx> Sync for RangeFrom<Idx>
where Idx: Sync,

ยง

impl<Idx> Unpin for RangeFrom<Idx>
where Idx: Unpin,

ยง

impl<Idx> UnwindSafe for RangeFrom<Idx>
where Idx: UnwindSafe,

Blanket Implementationsยง

Sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

Sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

Sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

Sourceยง

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Sourceยง

impl<T> CloneToUninit for T
where T: Clone,

Sourceยง

unsafe fn clone_to_uninit(&self, dest: *mut u8)

๐Ÿ”ฌThis is a nightly-only experimental API. (clone_to_uninit #126799)
Performs copy-assignment from self to dest. Read more
Sourceยง

impl<T> From<T> for T

Sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

Sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

Sourceยง

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Sourceยง

impl<T> ToOwned for T
where T: Clone,

Sourceยง

type Owned = T

The resulting type after obtaining ownership.
Sourceยง

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Sourceยง

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Sourceยง

type Error = Infallible

The type returned in the event of a conversion error.
Sourceยง

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Sourceยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Sourceยง

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
ะ›ัƒั‡ัˆะธะน ั‡ะฐัั‚ะฝั‹ะน ั…ะพัั‚ะธะฝะณ