Expand description

Safely cast between numbers.

The extension trait NumericCast adds a generic method numeric_cast for all number types. The method allows users to safely cast a number to another type without losing precision.

If the value can not be represented by the target type, the method will panic with a message which tells the value, the source type name and the target type name.

As numeric_cast is marked by track_caller, the panic location will be exactly where you call the method.

This library optimizes for code bloat. In most use cases, numeric cast always succeeds at runtime, so the panic function is split from normal control flow to reduce performance impact.


use numeric_cast::NumericCast;

let entries: u64 = 1024;

let capacity = entries.numeric_cast::<usize>();
let offset: isize = entries.numeric_cast(); // by inference
use numeric_cast::NumericCast;

let n: i32 = -1;
let len: usize = n.numeric_cast(); // panic here