Function core::num::flt2dec::to_shortest_str
source · pub fn to_shortest_str<'a, T, F>(
format_shortest: F,
v: T,
sign: Sign,
frac_digits: usize,
buf: &'a mut [MaybeUninit<u8>],
parts: &'a mut [MaybeUninit<Part<'a>>]
) -> Formatted<'a>where
T: DecodableFloat,
F: FnMut(&Decoded, &'a mut [MaybeUninit<u8>]) -> (&'a [u8], i16),
flt2dec
)Expand description
Formats the given floating point number into the decimal form with at least
given number of fractional digits. The result is stored to the supplied parts
array while utilizing given byte buffer as a scratch. upper
is currently
unused but left for the future decision to change the case of non-finite values,
i.e., inf
and nan
. The first part to be rendered is always a Part::Sign
(which can be an empty string if no sign is rendered).
format_shortest
should be the underlying digit-generation function.
It should return the part of the buffer that it initialized.
You probably would want strategy::grisu::format_shortest
for this.
frac_digits
can be less than the number of actual fractional digits in v
;
it will be ignored and full digits will be printed. It is only used to print
additional zeroes after rendered digits. Thus frac_digits
of 0 means that
it will only print given digits and nothing else.
The byte buffer should be at least MAX_SIG_DIGITS
bytes long.
There should be at least 4 parts available, due to the worst case like
[+][0.][0000][2][0000]
with frac_digits = 10
.