The nz crate provides a collection of macros that simplify the creation
of the NonZero type. With these macros, you can easily generate constants
of the generic type using literals, constant values or expressions at
compiletime.
All changes to nz crate are documented in CHANGELOG.md.
- No unsafe code
- No dependencies
no_stdcompatible- Supports every type that implements
ZeroablePrimitive - Compile-time evaluation
use std::num::NonZero;
// A `NonZero<T>` type can be constructed from different types of
// arguments with the matching `nz` macro.
// Such argument can be an integer literal,
const NZ_MIN: NonZero<u8> = nz::u8!(1);
let nz_two = nz::u8!(2);
// a constant value,
const NZ_MAX: NonZero<u8> = nz::u8!(u8::MAX);
const SIX: u8 = 6;
let six = nz::u8!(SIX);
// or even a constant expression.
const RES: NonZero<u8> = nz::u8!({ 3 + 7 } - NZ_MIN.get());
let res = nz::u8!((NZ_MIN.get() & NZ_MAX.get()) + 7);
let five = nz::u8!({ const FIVE: u8 = 5; FIVE });
// However, a non-constant expression results in a compile-time error.
// const __ERR: NonZero<u8> = nz::u8!({ 3 + 7 } - nz_two.get());This library is distributed under the terms of either of the following licenses at your option: