Struct std::num::NonZeroI641.34.0[][src]

#[repr(transparent)]
pub struct NonZeroI64(_);
Expand description

An integer that is known not to equal zero.

This enables some memory layout optimization. For example, Option<NonZeroI64> is the same size as i64:

use std::mem::size_of;
assert_eq!(size_of::<Option<core::num::NonZeroI64>>(), size_of::<i64>());
Run

Implementations

impl NonZeroI64[src]

pub const unsafe fn new_unchecked(n: i64) -> NonZeroI641.34.0 (const: 1.34.0)[src]

Creates a non-zero without checking the value.

Safety

The value must not be zero.

pub const fn new(n: i64) -> Option<NonZeroI64>1.34.0 (const: 1.47.0)[src]

Creates a non-zero if the given value is not zero.

pub const fn get(self) -> i641.34.0 (const: 1.34.0)[src]

Returns the value as a primitive type.

impl NonZeroI64[src]

pub const fn leading_zeros(self) -> u321.53.0 (const: 1.53.0)[src]

Returns the number of leading zeros in the binary representation of self.

On many architectures, this function can perform better than leading_zeros() on the underlying integer type, as special handling of zero can be avoided.

Examples

Basic usage:

let n = std::num::NonZeroI64::new(-1i64).unwrap();

assert_eq!(n.leading_zeros(), 0);
Run

pub const fn trailing_zeros(self) -> u321.53.0 (const: 1.53.0)[src]

Returns the number of trailing zeros in the binary representation of self.

On many architectures, this function can perform better than trailing_zeros() on the underlying integer type, as special handling of zero can be avoided.

Examples

Basic usage:

let n = std::num::NonZeroI64::new(0b0101000).unwrap();

assert_eq!(n.trailing_zeros(), 3);
Run

Trait Implementations

impl Binary for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter.

impl BitOr<NonZeroI64> for i641.45.0[src]

type Output = NonZeroI64

The resulting type after applying the | operator.

pub fn bitor(self, rhs: NonZeroI64) -> <i64 as BitOr<NonZeroI64>>::Output[src]

Performs the | operation. Read more

impl BitOr<NonZeroI64> for NonZeroI641.45.0[src]

type Output = NonZeroI64

The resulting type after applying the | operator.

pub fn bitor(self, rhs: NonZeroI64) -> <NonZeroI64 as BitOr<NonZeroI64>>::Output[src]

Performs the | operation. Read more

impl BitOr<i64> for NonZeroI641.45.0[src]

type Output = NonZeroI64

The resulting type after applying the | operator.

pub fn bitor(self, rhs: i64) -> <NonZeroI64 as BitOr<i64>>::Output[src]

Performs the | operation. Read more

impl BitOrAssign<NonZeroI64> for NonZeroI641.45.0[src]

pub fn bitor_assign(&mut self, rhs: NonZeroI64)[src]

Performs the |= operation. Read more

impl BitOrAssign<i64> for NonZeroI641.45.0[src]

pub fn bitor_assign(&mut self, rhs: i64)[src]

Performs the |= operation. Read more

impl Clone for NonZeroI64[src]

pub fn clone(&self) -> NonZeroI64[src]

Returns a copy of the value. Read more

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl Debug for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter. Read more

impl Display for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter. Read more

impl From<NonZeroI16> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroI16) -> NonZeroI64[src]

Converts NonZeroI16 to NonZeroI64 losslessly.

impl From<NonZeroI32> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroI32) -> NonZeroI64[src]

Converts NonZeroI32 to NonZeroI64 losslessly.

impl From<NonZeroI64> for i641.31.0[src]

pub fn from(nonzero: NonZeroI64) -> i64[src]

Converts a NonZeroI64 into an i64

impl From<NonZeroI64> for NonZeroI1281.41.0[src]

pub fn from(small: NonZeroI64) -> NonZeroI128[src]

Converts NonZeroI64 to NonZeroI128 losslessly.

impl From<NonZeroI8> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroI8) -> NonZeroI64[src]

Converts NonZeroI8 to NonZeroI64 losslessly.

impl From<NonZeroU16> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroU16) -> NonZeroI64[src]

Converts NonZeroU16 to NonZeroI64 losslessly.

impl From<NonZeroU32> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroU32) -> NonZeroI64[src]

Converts NonZeroU32 to NonZeroI64 losslessly.

impl From<NonZeroU8> for NonZeroI641.41.0[src]

pub fn from(small: NonZeroU8) -> NonZeroI64[src]

Converts NonZeroU8 to NonZeroI64 losslessly.

impl FromStr for NonZeroI641.35.0[src]

type Err = ParseIntError

The associated error which can be returned from parsing.

pub fn from_str(src: &str) -> Result<NonZeroI64, <NonZeroI64 as FromStr>::Err>[src]

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

impl Hash for NonZeroI64[src]

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher
[src]

Feeds this value into the given Hasher. Read more

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher
1.3.0[src]

Feeds a slice of this type into the given Hasher. Read more

impl LowerHex for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter.

impl Octal for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter.

impl Ord for NonZeroI64[src]

pub fn cmp(&self, other: &NonZeroI64) -> Ordering[src]

This method returns an Ordering between self and other. Read more

#[must_use]
fn max(self, other: Self) -> Self
1.21.0[src]

Compares and returns the maximum of two values. Read more

#[must_use]
fn min(self, other: Self) -> Self
1.21.0[src]

Compares and returns the minimum of two values. Read more

#[must_use]
fn clamp(self, min: Self, max: Self) -> Self
1.50.0[src]

Restrict a value to a certain interval. Read more

impl PartialEq<NonZeroI64> for NonZeroI64[src]

pub fn eq(&self, other: &NonZeroI64) -> bool[src]

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

pub fn ne(&self, other: &NonZeroI64) -> bool[src]

This method tests for !=.

impl PartialOrd<NonZeroI64> for NonZeroI64[src]

pub fn partial_cmp(&self, other: &NonZeroI64) -> Option<Ordering>[src]

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

#[must_use]
fn lt(&self, other: &Rhs) -> bool
1.0.0[src]

This method tests less than (for self and other) and is used by the < operator. Read more

#[must_use]
fn le(&self, other: &Rhs) -> bool
1.0.0[src]

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

#[must_use]
fn gt(&self, other: &Rhs) -> bool
1.0.0[src]

This method tests greater than (for self and other) and is used by the > operator. Read more

#[must_use]
fn ge(&self, other: &Rhs) -> bool
1.0.0[src]

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl TryFrom<NonZeroI128> for NonZeroI641.49.0[src]

pub fn try_from(
    value: NonZeroI128
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<NonZeroI128>>::Error>
[src]

Attempts to convert NonZeroI128 to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroUsize1.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroUsize, <NonZeroUsize as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroUsize.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroI321.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroI32, <NonZeroI32 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroI32.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroIsize1.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroIsize, <NonZeroIsize as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroIsize.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroU161.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroU16, <NonZeroU16 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroU16.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroI81.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroI8, <NonZeroI8 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroI8.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroU641.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroU64, <NonZeroU64 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroU64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroU321.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroU32, <NonZeroU32 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroU32.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroU1281.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroU128, <NonZeroU128 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroU128.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroU81.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroU8, <NonZeroU8 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroU8.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroI64> for NonZeroI161.49.0[src]

pub fn try_from(
    value: NonZeroI64
) -> Result<NonZeroI16, <NonZeroI16 as TryFrom<NonZeroI64>>::Error>
[src]

Attempts to convert NonZeroI64 to NonZeroI16.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroIsize> for NonZeroI641.49.0[src]

pub fn try_from(
    value: NonZeroIsize
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<NonZeroIsize>>::Error>
[src]

Attempts to convert NonZeroIsize to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroU128> for NonZeroI641.49.0[src]

pub fn try_from(
    value: NonZeroU128
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<NonZeroU128>>::Error>
[src]

Attempts to convert NonZeroU128 to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroU64> for NonZeroI641.49.0[src]

pub fn try_from(
    value: NonZeroU64
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<NonZeroU64>>::Error>
[src]

Attempts to convert NonZeroU64 to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<NonZeroUsize> for NonZeroI641.49.0[src]

pub fn try_from(
    value: NonZeroUsize
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<NonZeroUsize>>::Error>
[src]

Attempts to convert NonZeroUsize to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl TryFrom<i64> for NonZeroI641.46.0[src]

pub fn try_from(
    value: i64
) -> Result<NonZeroI64, <NonZeroI64 as TryFrom<i64>>::Error>
[src]

Attempts to convert i64 to NonZeroI64.

type Error = TryFromIntError

The type returned in the event of a conversion error.

impl UpperHex for NonZeroI64[src]

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>[src]

Formats the value using the given formatter.

impl Copy for NonZeroI64[src]

impl Eq for NonZeroI64[src]

impl StructuralEq for NonZeroI64[src]

impl StructuralPartialEq for NonZeroI64[src]

Auto Trait Implementations

impl RefUnwindSafe for NonZeroI64

impl Send for NonZeroI64

impl Sync for NonZeroI64

impl Unpin for NonZeroI64

impl UnwindSafe for NonZeroI64

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

pub fn into(self) -> U[src]

Performs the conversion.

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T[src]

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)[src]

🔬 This is a nightly-only experimental API. (toowned_clone_into #41263)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToString for T where
    T: Display + ?Sized
[src]

pub default fn to_string(&self) -> String[src]

Converts the given value to a String. Read more

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.