Struct abi_stable::sabi_types::version::VersionStrings [−][src]
#[repr(transparent)]pub struct VersionStrings {
pub version: RStr<'static>,
}
Expand description
The <major>.<minor>.<patch>
version of a library,
Post 1.0 major version
Major versions are mutually incompatible for both users and implementors.
Minor allow users to have a version less than or equal to that of the implementor, and disallows implementors from making changes that would break any previous minor release (with the same major number).
Patch cannot change the api/abi of the library at all,fixes only.
Pre 1.0 version
Minor versions are mutually incompatible for both users and implementors.
Patch cannot change the api/abi of the library at all,fixes only.
Example
use abi_stable::sabi_types::VersionStrings;
let v1_0_0=VersionStrings::new("1.0.0").parsed().unwrap();
let v1_0_5=VersionStrings::new("1.0.5").parsed().unwrap();
let v1_1_0=VersionStrings::new("1.1.0").parsed().unwrap();
let v2_0_0=VersionStrings::new("1.0.5").parsed().unwrap();
assert!( v1_0_0.is_compatible(v1_0_5),"'{}' '{}'",v1_0_0,v1_0_5);
assert!( v1_0_5.is_compatible(v1_1_0),"'{}' '{}'",v1_0_5,v1_1_0);
assert!( !v1_1_0.is_compatible(v2_0_0),"'{}' '{}'",v1_1_0,v2_0_0);
Fields
version: RStr<'static>
Implementations
Constructs a VersionStrings from a string with the “major.minor.patch” format,where each one is a valid number.
This does not check whether the string is correctly formatted,
that check is done inside VersionStrings::parsed
/VersionNumber::new
.
Example
use abi_stable::sabi_types::VersionStrings;
static VERSION:VersionStrings=VersionStrings::new("0.1.2");
Attempts to convert a VersionStrings
into a VersionNumber
Errors
This returns a ParseVersionError
if the string is not correctly formatted.
Example
use abi_stable::sabi_types::{VersionNumber,VersionStrings};
static VERSION:VersionStrings=VersionStrings::new("0.1.2");
assert_eq!( VERSION.parsed(), Ok(VersionNumber{major:0,minor:1,patch:2}) );
let err_version=VersionStrings::new("0.a.2.b");
assert!( err_version.parsed().is_err() );
Trait Implementations
type StaticEquivalent = _static_VersionStrings
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
type IsNonZeroType = <RStr<'static> as __StableAbi>::IsNonZeroType
type IsNonZeroType = <RStr<'static> as __StableAbi>::IsNonZeroType
Whether this type has a single invalid bit-pattern. Read more
The layout of the type provided by implementors.
const
-equivalents of the associated types.
Auto Trait Implementations
impl RefUnwindSafe for VersionStrings
impl Send for VersionStrings
impl Sync for VersionStrings
impl Unpin for VersionStrings
impl UnwindSafe for VersionStrings
Blanket Implementations
Mutably borrows from an owned value. Read more
type ROwned = T
type ROwned = T
The owned type, stored in RCow::Owned
type ForSelf = WithMetadata_<T, T>
type ForSelf = WithMetadata_<T, T>
This is always WithMetadata_<Self, Self>
Compares the address of self
with the address of other
. Read more
Emulates the pipeline operator, allowing method syntax in more places. Read more
The same as piped
except that the function takes &Self
Useful for functions that take &Self
instead of Self
. Read more
The same as piped
, except that the function takes &mut Self
.
Useful for functions that take &mut Self
instead of Self
. Read more
Mutates self using a closure taking self by mutable reference, passing it along the method chain. Read more
Observes the value of self, passing it along unmodified. Useful in long method chains. Read more
Performs a conversion with Into
.
using the turbofish .into_::<_>()
syntax. Read more
Performs a reference to reference conversion with AsRef
,
using the turbofish .as_ref_::<_>()
syntax. Read more
Performs a mutable reference to mutable reference conversion with AsMut
,
using the turbofish .as_mut_::<_>()
syntax. Read more
unsafe fn transmute_element<T>(
self
) -> <Self as CanTransmuteElement<T>>::TransmutedPtr where
Self: CanTransmuteElement<T>,
unsafe fn transmute_element<T>(
self
) -> <Self as CanTransmuteElement<T>>::TransmutedPtr where
Self: CanTransmuteElement<T>,
Transmutes the element type of this pointer.. Read more
type Type = T
type Type = T
This is always Self
.
Converts a value back to the original type.
Converts a mutable reference back to the original type.
Converts a box back to the original type.
Converts an Arc back to the original type. Read more
Converts an Rc back to the original type. Read more
Converts a value back to the original type.
Converts a reference back to the original type.
Converts a mutable reference back to the original type.
Converts a box back to the original type.
Converts an Arc back to the original type.
Converts an Rc back to the original type.