summaryrefslogtreecommitdiffstats
path: root/third_party/rust/libm/README.md
blob: b864b5df8e79c449d6a9c9f117ed305ce62b8335 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# `libm`

A port of [MUSL]'s libm to Rust.

[MUSL]: https://musl.libc.org/

## Goals

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

[wasm]: https://github.com/rust-lang/libm/milestone/1
[pr]: https://github.com/rust-lang/compiler-builtins/pull/248
[core]: https://github.com/rust-lang/libm/milestone/2

## 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](https://docs.rs/libm).

[on crates.io]: https://crates.io/crates/libm

## Benchmark
[benchmark]: #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](CONTRIBUTING.md)

## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
  http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

### Contribution

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.