Fork of https://github.com/dtolnay/itoa
58e20ae3f3 | ||
---|---|---|
.github | ||
benches | ||
src | ||
tests | ||
.clippy.toml | ||
.gitignore | ||
Cargo.toml | ||
LICENSE-APACHE | ||
LICENSE-MIT | ||
README.md | ||
performance.png |
README.md
itoa
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.
Version requirement: rustc 1.36+
[dependencies]
itoa = "0.4"
Performance (lower is better)
Example
fn main() {
let mut buffer = itoa::Buffer::new();
let printed = buffer.format(128u64);
assert_eq!(printed, "128");
}
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.
The write
function is only available when the std
feature is enabled
(default is enabled). The return value gives the number of bytes written.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.