2 stable releases
1.0.1 | Nov 9, 2023 |
---|---|
1.0.0 | Nov 8, 2023 |
#1411 in Rust patterns
39 downloads per month
13KB
208 lines
Provides the nz
macro for constructing a
std::num::NonZero*
from an integer constant.
Example
Usage
#![feature(inline_const)]
use notzero::nz;
use std::num::NonZeroU64;
let two = nz!(2u16); // returns a `NonZeroU16`
assert_eq!(two.get(), 2u16);
// infers the argument's type from the returned `NonZero`
const THREE: NonZeroU64 = nz!(3);
assert_eq!(THREE.get(), 3u64);
const FOUR: i8 = -4;
let fourz = nz!(FOUR); // returns a `NonZeroI8`
assert_eq!(fourz.get(), -4i8);
Zero argument
#![feature(inline_const)]
const ZERO: u8 = 0;
let _ = notzero::nz!(ZERO);
the above code produces this compile-time error:
error[E0080]: evaluation of `main::_doctest_main_src_lib_rs_27_0::{constant#0}` failed
--> src/lib.rs:32:9
|
8 | let _ = notzero::nz!(ZERO);
| ^^^^^^^^^^^^^^^^^^ the evaluated program panicked at 'passed in a `0` argument', src/lib.rs:8:9
|
= note: this error originates in the macro `notzero::nz` (in Nightly builds, run with -Z macro-backtrace for more info)
No-std support
notzero
is #![no_std]
, it can be used anywhere Rust can be used.
Minimum Supported Rust Version
This crate currently requires users to enable the inline_const
unstable feature,
which means that it requires the nightly compiler.
This crate will support stable Rust once inline_const
stabilizes,
requiring only the Rust version where the feature is stabilized.
Dependencies
~290KB