Struct dia_semver::Range

pub struct Range { /* fields omitted */ }

👎 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.
• Length of the string must be equal to or smaller than 4096 bytes. It’s for protection against flood attack.

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

impl From<&'_ Semver> for Range

fn from(semver: &Semver) -> Self

Performs the conversion.

impl From<Range<Semver>> for Range

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

Performs the conversion.

impl From<RangeInclusive<Semver>> for Range

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

Performs the conversion.

impl From<Semver> for Range

fn from(semver: Semver) -> Self

Performs the conversion.

impl FromStr for Range

type Err = ParseSemverError

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.

pub 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 StructuralEq for Range

impl StructuralPartialEq for Range