Struct dia_semver::Range

pub struct Range { /* private fields */ }

👎 Deprecated:

Beta

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 protection against flood attack, max length of the string is one of:

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

Notes

Large ranges, such as [,], (,), [start,], [,end]… are not supported. Technically it’s doable, but using such wild ranges in software development is not recommended.

Examples

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

Implementations

impl Range

pub fn start(&self) -> &Semver

👎 Deprecated:

Beta

Start of the range

pub fn end(&self) -> &Semver

👎 Deprecated:

Beta

End of the range

pub fn is_empty(&self) -> bool

👎 Deprecated:

Beta

Checks if this range is empty

pub fn contains(&self, semver: &Semver) -> bool

👎 Deprecated:

Beta

Checks if this range contains a semver

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a copy 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<RangeInclusive<Semver>> for Range

fn from(range: RangeInclusive<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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Range> for Range

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

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

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

This method tests for !=.

impl Eq for Range

impl StructuralEq for Range

impl StructuralPartialEq for Range