bf16floating point types for Rust
bf16 types provides conversion operations as a normal Rust floating point type, but since they are primarily leveraged for
minimal floating point storage and most major hardware does not implement them, all math operations should be done as an
This crate provides
no_std support by default so can easily be used in embedded
code where a smaller float format is most useful.
Requires Rust 1.32 or greater. If you need support for older versions of Rust, use versions 1.3 and earlier of this crate.
See the crate documentation for more details.
serde - Implement
Deserialize traits for
bf16. This adds a dependency on the
use-intrinsics - Use hardware intrinsics for
bf16 conversions if available on the compiler host target. By
default, without this feature, conversions are done only in software, which will be the fallback if the host target does
not have hardware support. Available only on Rust nightly channel.
alloc - Enable use of the
alloc crate when not using the
This enables the
vec module, which contains zero-copy conversions for the
Vec type. This allows fast conversion between
Vec<u16> bits and
Vec<bf16> arrays, and vice versa. Requires Rust 1.36 or greater.
std - Enable features that depend on the Rust
std library, including everything in the
std feature enables runtime CPU feature detection when the
use-intrsincis feature is also enabled.
Without this feature detection, intrinsics are only used when compiler host target supports them.
num-traits - Enable
FloatCore trait implementations from the
bytemuck - Enable
Pod trait implementations from the
This library is distributed under the terms of either of:
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.