gecko-dev/third_party/rust/itoa
Nathan Froyd b93bf873ba Bug 1502964 - part 2 - update winapi to froydnj/winapi-rs#aarch64; r=ted.mielczarek 2018-11-02 10:56:08 -04:00
..
benches Bug 1449087 part 1 - Upgrade cssparser to 0.23.4 for serialization fix. r=emilio 2018-04-04 08:42:10 +10:00
src Bug 1449087 part 1 - Upgrade cssparser to 0.23.4 for serialization fix. r=emilio 2018-04-04 08:42:10 +10:00
tests Bug 1449087 part 1 - Upgrade cssparser to 0.23.4 for serialization fix. r=emilio 2018-04-04 08:42:10 +10:00
.cargo-checksum.json Bug 1502964 - part 2 - update winapi to froydnj/winapi-rs#aarch64; r=ted.mielczarek 2018-11-02 10:56:08 -04:00
Cargo.toml Bug 1449087 part 1 - Upgrade cssparser to 0.23.4 for serialization fix. r=emilio 2018-04-04 08:42:10 +10:00
LICENSE-APACHE
LICENSE-MIT
README.md Bug 1449087 part 1 - Upgrade cssparser to 0.23.4 for serialization fix. r=emilio 2018-04-04 08:42:10 +10:00

README.md

itoa

Build Status Latest Version

This crate provides fast functions for printing integer primitives to an io::Write or a fmt::Write. The implementation comes straight from libcore but avoids the performance penalty of going through fmt::Formatter.

See also dtoa for printing floating point primitives.

Performance (lower is better)

performance

Functions

extern crate itoa;

// write to a vector or other io::Write
let mut buf = Vec::new();
itoa::write(&mut buf, 128u64)?;
println!("{:?}", buf);

// write to a stack buffer
let mut bytes = [b'\0'; 20];
let n = itoa::write(&mut bytes[..], 128u64)?;
println!("{:?}", &bytes[..n]);

// write to a String
let mut s = String::new();
itoa::fmt(&mut s, 128u64)?;
println!("{}", s);

The function signatures are:

fn write<W: io::Write, V: itoa::Integer>(writer: W, value: V) -> io::Result<usize>;

fn fmt<W: fmt::Write, V: itoa::Integer>(writer: W, value: V) -> fmt::Result;

where itoa::Integer is implemented for i8, u8, i16, u16, i32, u32, i64, u64, i128, u128, isize and usize. 128-bit integer support is only available with the nightly compiler when the i128 feature is enabled for this crate. The return value gives the number of bytes written.

The write function is only available when the std feature is enabled (default is enabled).

Dependency

Itoa is available on crates.io. Use the following in Cargo.toml:

[dependencies]
itoa = "0.4"

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in itoa by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.