rust/library/compiler-builtins/libm
Trevor Gross beb34db83d Split cast into cast and cast_lossy
There is a difference in intent between wishing to cast and truncate the
value, and expecting the input to be within range. To make this clear,
add separate `cast_lossy` and `cast_from_lossy` to indicate what that
truncation is intended, leaving `cast` and `cast_from` to only be casts
that expected not to truncate.

Actually enforcing this at runtime is likely to have a cost, so just
`debug_assert!` that `cast` doesn't truncate.
2025-01-11 18:28:45 -05:00
..
.github/workflows ci: Only update the github ref for pull requests 2025-01-06 15:37:16 -05:00
ci Enable MPFR tests on i586 2025-01-06 15:41:39 -05:00
crates Add tests against MPFR for remquo and remquof 2025-01-10 16:04:16 -05:00
etc Replace "intrinsic" config with "arch" config 2025-01-06 20:17:01 -05:00
src Split cast into cast and cast_lossy 2025-01-11 18:28:45 -05:00
.editorconfig add generic libm helper 2023-01-17 20:41:24 +01:00
.git-blame-ignore-revs Add a .git-blame-ignore-revs file 2024-10-26 20:30:41 -05:00
.gitignore Introduce musl-math-sys for bindings to musl math symbols 2024-10-28 12:59:38 -05:00
.rustfmt.toml Add a rustfmt.toml file matching rust-lang/rust 2024-10-26 20:28:28 -05:00
build.rs Add f16 and f128 configuration from compiler-builtins 2024-12-29 02:33:41 -05:00
Cargo.toml Rename unstable-test-support to unstable-public-internals 2025-01-05 22:13:11 -05:00
CHANGELOG.md chore: release v0.2.11 2024-10-28 20:08:07 +00:00
configure.rs Account for optimization levels other than numbers 2025-01-07 17:58:54 -05:00
CONTRIBUTING.md Remove tests against system musl 2024-12-22 12:39:27 +00:00
LICENSE.txt Update licensing to MIT AND (MIT OR Apache-2.0) 2024-10-26 17:09:57 -05:00
README.md Use https: links in README.md 2024-11-14 18:13:10 +00:00

libm

A port of MUSL's libm to Rust.

Goals

The short term goal of this library is to enable math support (e.g. sin, atan2) for the wasm32-unknown-unknown target (cf. rust-lang/compiler-builtins). The longer term goal is to enable math support in the core crate.

Already usable

This crate is on crates.io and can be used today in stable #![no_std] programs.

The API documentation can be found here.

Benchmark

The benchmarks are located in crates/libm-bench and require a nightly Rust toolchain. To run all benchmarks:

cargo +nightly bench --all

Contributing

Please check CONTRIBUTING.md

Minimum Rust version policy

This crate supports rustc 1.63 and newer.

License

Usage is licensed under the MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT).

Contribution

Contributions are licensed under both the MIT license and the Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0). 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 mentioned, without any additional terms or conditions.

See LICENSE.txt for full details.