devela 0.27.0

A development layer of coherence.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// devela::text::fmt::num
//
//! Defines [`FmtNum`].
//

#[doc = crate::_tags!(fmt num)]
/// Const number formatter.
#[doc = crate::_doc_location!("text/fmt")]
///
/// Provides a lightweight, allocation-free interface
/// for writing numeric values into an existing byte buffer.
///
/// # Example
/// ```
/// # use devela::FmtNum;
/// let mut buf = [0u8; 8];
/// let len = FmtNum(-123i32).write(&mut buf, 0);
/// assert_eq!(&buf[..len], b"-123");
///
/// let len = FmtNum(42u8).write(&mut buf, 0);
/// assert_eq!(&buf[..len], b"42");
///
/// let float_str = FmtNum(-4.2_f32).as_str_into(&mut buf, 2);
/// assert_eq!(float_str, "-4.19"); // be aware of floating-point inexactitudes
/// ```
#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct FmtNum<T>(pub T);