| 1 |
itoa |
| 2 |
==== |
| 3 |
|
| 4 |
[<img alt="github" src="https://img.shields.io/badge/github-dtolnay/itoa-8da0cb?style=for-the-badge&labelColor=555555&logo=github" height="20">](https://github.com/dtolnay/itoa) |
| 5 |
[<img alt="crates.io" src="https://img.shields.io/crates/v/itoa.svg?style=for-the-badge&color=fc8d62&logo=rust" height="20">](https://crates.io/crates/itoa) |
| 6 |
[<img alt="docs.rs" src="https://img.shields.io/badge/docs.rs-itoa-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs" height="20">](https://docs.rs/itoa) |
| 7 |
[<img alt="build status" src="https://img.shields.io/github/actions/workflow/status/dtolnay/itoa/ci.yml?branch=master&style=for-the-badge" height="20">](https://github.com/dtolnay/itoa/actions?query=branch%3Amaster) |
| 8 |
|
| 9 |
This crate provides a fast conversion of integer primitives to decimal strings. |
| 10 |
The implementation comes straight from [libcore] but avoids the performance |
| 11 |
penalty of going through [`core::fmt::Formatter`]. |
| 12 |
|
| 13 |
See also [`ryu`] for printing floating point primitives. |
| 14 |
|
| 15 |
*Version requirement: rustc 1.36+* |
| 16 |
|
| 17 |
[libcore]: https://github.com/rust-lang/rust/blob/b8214dc6c6fc20d0a660fb5700dca9ebf51ebe89/src/libcore/fmt/num.rs#L201-L254 |
| 18 |
[`core::fmt::Formatter`]: https://doc.rust-lang.org/std/fmt/struct.Formatter.html |
| 19 |
[`ryu`]: https://github.com/dtolnay/ryu |
| 20 |
|
| 21 |
```toml |
| 22 |
[dependencies] |
| 23 |
itoa = "1.0" |
| 24 |
``` |
| 25 |
|
| 26 |
<br> |
| 27 |
|
| 28 |
## Example |
| 29 |
|
| 30 |
```rust |
| 31 |
fn main() { |
| 32 |
let mut buffer = itoa::Buffer::new(); |
| 33 |
let printed = buffer.format(128u64); |
| 34 |
assert_eq!(printed, "128"); |
| 35 |
} |
| 36 |
``` |
| 37 |
|
| 38 |
<br> |
| 39 |
|
| 40 |
## Performance (lower is better) |
| 41 |
|
| 42 |
 |
| 43 |
|
| 44 |
<br> |
| 45 |
|
| 46 |
#### License |
| 47 |
|
| 48 |
<sup> |
| 49 |
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version |
| 50 |
2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option. |
| 51 |
</sup> |
| 52 |
|
| 53 |
<br> |
| 54 |
|
| 55 |
<sub> |
| 56 |
Unless you explicitly state otherwise, any contribution intentionally submitted |
| 57 |
for inclusion in this crate by you, as defined in the Apache-2.0 license, shall |
| 58 |
be dual licensed as above, without any additional terms or conditions. |
| 59 |
</sub> |