pub struct oi8(/* private fields */);
Implementations§
Source§impl oi8
impl oi8
Sourcepub const fn checked_add(self, rhs: oi8) -> oi8
pub const fn checked_add(self, rhs: oi8) -> oi8
Checked integer addition. Computes self + rhs
, returning None
if overflow occurred.
§Examples
Basic usage:
assert!(oint::structural_eq!(oint::oi8::from(i8::MAX - 2).checked_add(1.into()), oint::oi8::from(i8::MAX - 1)));
assert!(oint::structural_eq!(oint::oi8::from(i8::MAX - 2).checked_add(3.into()), oint::oi8::from(None)));
Sourcepub const fn checked_sub(self, rhs: oi8) -> oi8
pub const fn checked_sub(self, rhs: oi8) -> oi8
Checked integer subtraction. Computes self - rhs
, returning None
if overflow occurred.
§Examples
Basic usage:
assert!(oint::structural_eq!(oint::oi8::from(i8::MIN + 2).checked_sub(1.into()), oint::oi8::from(i8::MIN + 1)));
assert!(oint::structural_eq!(oint::oi8::from(i8::MIN + 2).checked_sub(3.into()), oint::oi8::from(None)));
Sourcepub const fn checked_mul(self, rhs: oi8) -> oi8
pub const fn checked_mul(self, rhs: oi8) -> oi8
Checked integer multiplication. Computes self * rhs
, returning None
if
overflow occurred.
§Examples
Basic usage:
assert!(oint::structural_eq!(oint::oi8::from(i8::MAX).checked_mul(1.into()), oint::oi8::from(Some(i8::MAX))));
assert!(oint::structural_eq!(oint::oi8::from(i8::MAX).checked_mul(2.into()), oint::oi8::from(None)));
Sourcepub const fn checked_div(self, rhs: oi8) -> oi8
pub const fn checked_div(self, rhs: oi8) -> oi8
Checked integer division. Computes self / rhs
, returning None
if rhs == 0
or the division results in overflow.
§Examples
Basic usage:
assert!(oint::structural_eq!(oint::oi8::from(i8::MIN + 1).checked_div((-1).into()), oint::oi8::from(i8::MAX)));
assert!(oint::structural_eq!(oint::oi8::from(i8::MIN).checked_div((-1).into()), oint::oi8::from(None)));
assert!(oint::structural_eq!(oint::oi8::from(1i8).checked_div(0.into()), oint::oi8::from(None)));
pub const fn checked_rem(self, rhs: oi8) -> oi8
pub const fn checked_shl(self, rhs: ou32) -> oi8
pub const fn checked_shr(self, rhs: ou32) -> oi8
pub const fn max(self, rhs: oi8) -> oi8
pub const fn min(self, rhs: oi8) -> oi8
pub const fn abs(self) -> oi8
pub const fn neg(self) -> oi8
pub const fn div_euclid(self, rhs: oi8) -> oi8
pub const fn structural_eq(self, rhs: oi8) -> bool
pub const fn structural_ne(self, rhs: oi8) -> bool
pub const fn indeterminate_eq(self, rhs: oi8) -> bool
pub const fn indeterminate_ne(self, rhs: oi8) -> bool
Methods from Deref<Target = Option<i8>>§
1.0.0 · Sourcepub fn as_ref(&self) -> Option<&T>
pub fn as_ref(&self) -> Option<&T>
Converts from &Option<T>
to Option<&T>
.
§Examples
Calculates the length of an Option<String>
as an Option<usize>
without moving the String
. The map
method takes the self
argument by value,
consuming the original, so this technique uses as_ref
to first take an Option
to a
reference to the value inside the original.
let text: Option<String> = Some("Hello, world!".to_string());
// First, cast `Option<String>` to `Option<&String>` with `as_ref`,
// then consume *that* with `map`, leaving `text` on the stack.
let text_length: Option<usize> = text.as_ref().map(|s| s.len());
println!("still can print text: {text:?}");
1.75.0 · Sourcepub fn as_slice(&self) -> &[T]
pub fn as_slice(&self) -> &[T]
Returns a slice of the contained value, if any. If this is None
, an
empty slice is returned. This can be useful to have a single type of
iterator over an Option
or slice.
Note: Should you have an Option<&T>
and wish to get a slice of T
,
you can unpack it via opt.map_or(&[], std::slice::from_ref)
.
§Examples
assert_eq!(
[Some(1234).as_slice(), None.as_slice()],
[&[1234][..], &[][..]],
);
The inverse of this function is (discounting
borrowing) [_]::first
:
for i in [Some(1234_u16), None] {
assert_eq!(i.as_ref(), i.as_slice().first());
}
1.40.0 · Sourcepub fn as_deref(&self) -> Option<&<T as Deref>::Target>where
T: Deref,
pub fn as_deref(&self) -> Option<&<T as Deref>::Target>where
T: Deref,
Converts from Option<T>
(or &Option<T>
) to Option<&T::Target>
.
Leaves the original Option in-place, creating a new one with a reference
to the original one, additionally coercing the contents via Deref
.
§Examples
let x: Option<String> = Some("hey".to_owned());
assert_eq!(x.as_deref(), Some("hey"));
let x: Option<String> = None;
assert_eq!(x.as_deref(), None);