#printing #comments #dtoa

dtoa

Fast functions for printing floating-point primitives to an io::Write

14 releases

Uses old Rust 2015

0.4.6 Jun 16, 2020
0.4.5 Jan 29, 2020
0.4.4 May 2, 2019
0.4.3 Jul 5, 2018
0.2.2 Jul 31, 2016

#2 in Value formatting

Download history 159671/week @ 2020-06-11 168613/week @ 2020-06-18 160444/week @ 2020-06-25 159536/week @ 2020-07-02 158880/week @ 2020-07-09 157820/week @ 2020-07-16 155537/week @ 2020-07-23 166189/week @ 2020-07-30 158242/week @ 2020-08-06 157408/week @ 2020-08-13 156075/week @ 2020-08-20 155672/week @ 2020-08-27 148552/week @ 2020-09-03 159821/week @ 2020-09-10 150781/week @ 2020-09-17 147268/week @ 2020-09-24

671,927 downloads per month
Used in 3,968 crates (21 directly)

MIT/Apache

36KB
473 lines

dtoa

github crates.io docs.rs build status

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.

Version requirement: rustc 1.0+

[dependencies]
dtoa = "0.4"

Performance (lower is better)

performance


Examples

use std::io;

fn main() -> io::Result<()> {
    // 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]);

    Ok(())
}

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.


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.

No runtime deps