Struct Range 

pub struct Range { /* private fields */ }

Range

A range can be respresented in string, following these rules:

• Start and end are placed inside one of [], [)…, separated by a comma.

• [ and ] are inclusive.

• ( and ) are exclusive.

• White spaces can be included. They will be ignored by parser.

• For unbounded ranges, start and/or end indexes must be inclusive.

• For protection against flood attack, max length of the string is one of:

  • 255 bytes (on 8-bit machines)
  • 4096 bytes (on larger machines)

Examples

use core::ops::RangeBounds;
use core::str::FromStr;
use dia_semver::{Range, Semver};

// An empty range
let range = Range::from(Semver::new(0, 1, 2)..Semver::new(0, 0, 0));
assert!(range.is_empty());

// Only one single semver
let range = Range::from(Semver::new(0, 1, 2));
assert!(range.contains(&Semver::new(0, 1, 2)));
assert!(range.contains(&Semver::new(0, 1, 3)) == false);

// Inclusive range
let range = Range::from_str("[0.1.2, 0.2.0-beta]")?;
assert!(range.contains(&Semver::new(0, 1, 3)));
assert!(range.contains(&Semver::from_str("0.2.0-alpha")?));
assert!(range.contains(&Semver::new(0, 2, 0)) == false);

// Exclusive range
let range = Range::from(Semver::new(0, 1, 2)..Semver::new(0, 2, 0));
assert!(range.contains(&Semver::new(0, 2, 0)) == false);

// Unbounded ranges
assert!(Range::from(..).contains(&Semver::new(1, 2, 0)));
assert!(Range::from_str("[ , 1]")?.contains(&Semver::from(1_u8)));
assert!(Range::from_str("[ , 1)")?.contains(&Semver::from(1_u8)) == false);

Implementations

impl Range

pub fn is_empty(&self) -> bool

Checks if this range is empty

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Range

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

Formats the value using the given formatter.

impl Display for Range

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

Formats the value using the given formatter.

impl From<&Semver> for Range

fn from(semver: &Semver) -> Self

Converts to this type from the input type.

impl From<Range<Semver>> for Range

fn from(range: Range<Semver>) -> Self

Converts to this type from the input type.

impl From<RangeFrom<Semver>> for Range

fn from(range: RangeFrom<Semver>) -> Self

Converts to this type from the input type.

impl From<RangeFull> for Range

fn from(_: RangeFull) -> Self

Converts to this type from the input type.

impl From<RangeInclusive<Semver>> for Range

fn from(range: RangeInclusive<Semver>) -> Self

Converts to this type from the input type.

impl From<RangeTo<Semver>> for Range

fn from(range: RangeTo<Semver>) -> Self

Converts to this type from the input type.

impl From<RangeToInclusive<Semver>> for Range

fn from(range: RangeToInclusive<Semver>) -> Self

Converts to this type from the input type.

impl From<Semver> for Range

fn from(semver: Semver) -> Self

Converts to this type from the input type.

impl FromStr for Range

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Range

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

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 PartialEq for Range

fn eq(&self, other: &Range) -> 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 RangeBounds<Semver> for Range

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

Start index bound.

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

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 Eq for Range

impl StructuralPartialEq for Range