Struct EngineVersion 

pub struct EngineVersion { /* private fields */ }

A version of an engine: 17, 8.4, 2022, 23ai.

Ordered by its numbers, the missing ones read as zero, so 8.4 is newer than 8 and the same as 8.4.0. The letters after the last digit are part of how the vendor writes it and not of its order: 23ai and 23 are one version, and a dialect that declares 23ai answers to oracle@23 too.

It is displayed as it was written, so a refusal and a manifest say the version in the user’s words.

use razeri_plugin_contract::EngineVersion;

let floor = EngineVersion::declared("15");
let asked: EngineVersion = "17".parse().unwrap();
assert!(floor < asked);
assert_eq!(asked.to_string(), "17");
assert_eq!("23ai".parse::<EngineVersion>().unwrap(), "23".parse().unwrap());

Implementations

impl EngineVersion

pub const fn declared(spelling: &str) -> Self

A version a dialect declares, read when the program is compiled.

A spelling that is not a version stops the build, so a dialect’s declared list can be a const:

use razeri_plugin_contract::EngineVersion;

const VERSIONS: &[EngineVersion] =
    &[EngineVersion::declared("15"), EngineVersion::declared("17")];
assert_eq!(VERSIONS[0].to_string(), "15");

Panics

When spelling is not a version; in a const, that is a compile error.

pub fn parse(spelling: &str) -> Result<Self, EngineVersionError>

Read a version written by a user.

Errors

EngineVersionError naming what is wrong and, where there is one, the spelling that is accepted.

pub fn as_str(&self) -> &str

The version as it was written.

pub const fn numbers(&self) -> [u32; 4]

The numbers of the version, the missing ones zero: 8.4 is [8, 4, 0, 0].

Trait Implementations

impl Clone for EngineVersion

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EngineVersion

impl Debug for EngineVersion

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

Formats the value using the given formatter.

impl Display for EngineVersion

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

Formats the value using the given formatter.

impl Eq for EngineVersion

impl FromStr for EngineVersion

type Err = EngineVersionError

The associated error which can be returned from parsing.

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

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

impl Hash for EngineVersion

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 Ord for EngineVersion

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for EngineVersion

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for EngineVersion

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for EngineVersion

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.