Fast functions for printing floating-point primitives to an io::Write
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
benches
src
tests
.gitignore
.travis.yml
Cargo.toml
LICENSE-APACHE
LICENSE-MIT
README.md
performance.png

README.md

dtoa

Build Status Latest Version

This crate provides fast functions for printing floating-point primitives to an io::Write. The implementation is a straightforward Rust port of Milo Yip's C++ implementation dtoa.h. The original C++ code of each function is included in comments.

See also itoa for printing integer primitives.

Performance (lower is better)

performance

Functions

extern crate dtoa;

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

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

The function signature is:

fn write<W: io::Write, V: dtoa::Floating>(writer: W, value: V) -> io::Result<()>

where dtoa::Floating is implemented for f32 and f64. The return value gives the number of bytes written.

Dependency

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

[dependencies]
dtoa = "0.4"

License

Licensed under either of

at your option.

Contribution

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