Trait NonZeroAble

pub trait NonZeroAble {
    type NonZero: NonZero;

    // Required methods
    fn as_nonzero(self) -> Option<Self::NonZero>;
    unsafe fn as_nonzero_unchecked(self) -> Self::NonZero;
}

A trait identifying integral types that have a non-zeroable equivalent.

Required Associated Types

type NonZero: NonZero

The concrete non-zero type represented by an implementation of this trait. For example, for u8’s implementation, it is NonZeroU8.

Required Methods

fn as_nonzero(self) -> Option<Self::NonZero>

Converts the integer to its non-zero equivalent.

Examples

Trying to convert zero

let n: u16 = 0;
assert_eq!(n.as_nonzero(), None);

Converting a non-zero value

let n: usize = 20;
let non0n: NonZeroUsize = n.as_nonzero().expect("should result in a converted value");
assert_eq!(non0n.get(), 20);

unsafe fn as_nonzero_unchecked(self) -> Self::NonZero

Converts the integer to its non-zero equivalent without checking for zeroness.

This corresponds to the new_unchecked function on the corresponding NonZero type.

Implementations on Foreign Types

impl NonZeroAble for u8

type NonZero = NonZero<u8>

fn as_nonzero(self) -> Option<NonZeroU8>

unsafe fn as_nonzero_unchecked(self) -> NonZeroU8

impl NonZeroAble for u16

type NonZero = NonZero<u16>

fn as_nonzero(self) -> Option<NonZeroU16>

unsafe fn as_nonzero_unchecked(self) -> NonZeroU16

impl NonZeroAble for u32

type NonZero = NonZero<u32>

fn as_nonzero(self) -> Option<NonZeroU32>

unsafe fn as_nonzero_unchecked(self) -> NonZeroU32

impl NonZeroAble for u64

type NonZero = NonZero<u64>

fn as_nonzero(self) -> Option<NonZeroU64>

unsafe fn as_nonzero_unchecked(self) -> NonZeroU64

impl NonZeroAble for u128

type NonZero = NonZero<u128>

fn as_nonzero(self) -> Option<NonZeroU128>

unsafe fn as_nonzero_unchecked(self) -> NonZeroU128

impl NonZeroAble for usize

type NonZero = NonZero<usize>

fn as_nonzero(self) -> Option<NonZeroUsize>

unsafe fn as_nonzero_unchecked(self) -> NonZeroUsize

Implementors