Creates a new inclusive range. Equivalent to writingstart..=end.

§Examples

usestd::ops::RangeInclusive;assert_eq!(3..=5, RangeInclusive::new(3,5));

Returns the lower bound of the range (inclusive).

When using an inclusive range for iteration, the values ofstart() andend() are unspecified after the iteration ended. To determinewhether the inclusive range is empty, use theis_empty() methodinstead of comparingstart() > end().

Note: the value returned by this method is unspecified after the rangehas been iterated to exhaustion.

§Examples

assert_eq!((3..=5).start(),&3);

Returns the upper bound of the range (inclusive).

When using an inclusive range for iteration, the values ofstart()andend() are unspecified after the iteration ended. To determinewhether the inclusive range is empty, use theis_empty() methodinstead of comparingstart() > end().

Note: the value returned by this method is unspecified after the rangehas been iterated to exhaustion.

§Examples

assert_eq!((3..=5).end(),&5);

Destructures theRangeInclusive into (lower bound, upper (inclusive) bound).

Note: the value returned by this method is unspecified after the rangehas been iterated to exhaustion.

§Examples

assert_eq!((3..=5).into_inner(), (3,5));

Returnstrue ifitem is contained in the range.

§Examples

assert!(!(3..=5).contains(&2));assert!( (3..=5).contains(&3));assert!( (3..=5).contains(&4));assert!( (3..=5).contains(&5));assert!(!(3..=5).contains(&6));assert!( (3..=3).contains(&3));assert!(!(3..=2).contains(&3));assert!( (0.0..=1.0).contains(&1.0));assert!(!(0.0..=1.0).contains(&f32::NAN));assert!(!(0.0..=f32::NAN).contains(&0.0));assert!(!(f32::NAN..=1.0).contains(&1.0));

This method always returnsfalse after iteration has finished:

letmutr =3..=5;assert!(r.contains(&3) && r.contains(&5));for _ inr.by_ref() {}// Precise field values are unspecified hereassert!(!r.contains(&3) && !r.contains(&5));

Returnstrue if the range contains no items.

§Examples

assert!(!(3..=5).is_empty());assert!(!(3..=3).is_empty());assert!( (3..=2).is_empty());

The range is empty if either side is incomparable:

assert!(!(3.0..=5.0).is_empty());assert!( (3.0..=f32::NAN).is_empty());assert!( (f32::NAN..=5.0).is_empty());

This method returnstrue after iteration has finished:

letmutr =3..=5;for _ inr.by_ref() {}// Precise field values are unspecified hereassert!(r.is_empty());

Returns the argument unchanged.

CallsU::from(self).

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