#string-conversion #float #display #double #floating-point #dtoa

pretty_dtoa

Configurable floating point number to string conversions, with many options for controlling various aspects of displaying floats

3 releases (breaking)

0.3.0 May 4, 2021
0.2.0 Mar 24, 2021
0.1.0 Jun 4, 2020

#153 in Value formatting

Download history 1389/week @ 2023-12-04 1220/week @ 2023-12-11 1763/week @ 2023-12-18 267/week @ 2023-12-25 1318/week @ 2024-01-01 991/week @ 2024-01-08 1099/week @ 2024-01-15 1504/week @ 2024-01-22 2003/week @ 2024-01-29 2960/week @ 2024-02-05 2491/week @ 2024-02-12 2113/week @ 2024-02-19 1767/week @ 2024-02-26 2247/week @ 2024-03-04 2101/week @ 2024-03-11 1838/week @ 2024-03-18

8,007 downloads per month
Used in 45 crates (6 directly)

MIT/Apache

36KB
694 lines

Pretty dtoa

Configurable float and double printing. pretty_dtoa Comes with lots of options for configuring different aspects of displaying floats, and has only 1 dependency total (including dependencies of dependencies), for very fast compile times.

This crate uses the ryu-floating-decimal crate (itself a fork of the ryu crate) to generate a "floating decimal", or a floating point with radix 10, and then it uses formatting rules particular to the configuration to create a formatted string.

This module is only slightly slow (usually between 1x and 2x slower than the default Display implementation for f64). Benchmarks can be run with cargo bench.

Consider using pretty_dtoa if the default behavior of Display and alternative float printing libraries like ryu is not ideal for one reason or another

Example

use pretty_dtoa::{dtoa, FmtFloatConfig};

let config = FmtFloatConfig::default()
     .force_no_e_notation()      // Don't use scientific notation
     .add_point_zero(true)       // Add .0 to the end of integers
     .max_significant_digits(4)  // Stop after the first 4 non-zero digits
     .radix_point(',')           // Use a ',' instead of a '.'
     .round();                   // Round after removing non-significant digits

 assert_eq!(dtoa(12459000.0, config), "12460000,0");

See the tests in src/lib.rs for examples of each feature, and the documentation to see all configurable features.

Dependencies

~74KB