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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

// devela::text::char::digits
//
//! Defines [`Digits`].
//

#[cfg(test)]
mod tests;

mod docs; // DOC_*
use docs::*;

mod u8;
mod u16;
mod u32;
mod u64;
mod u128;
// mod u256; // WIP
mod usize;

#[doc = crate::_tags!(text num namespace)]
/// Provides ASCII digit operations and conversions for unsigned integer primitives.
#[doc = crate::_doc_location!("text/char")]
///
/// Enables efficient ASCII digit extraction, counting, and conversion
/// for unsigned integer types. Most operations are `const` and designed for
/// performance-critical scenarios like number formatting.
///
/// It converts **numbers → digits** for display/formatting.
///
/// # Methods
///
/// Most methods are implemented for all the unsigned integer primitives:
/// [u8](#impl-Digits<u8>),
/// [u16](#impl-Digits<u16>),
/// [u32](#impl-Digits<u32>),
/// [u64](#impl-Digits<u64>),
/// [u128](#impl-Digits<u128>),
/// [usize](#impl-Digits<usize>).
///
/// Common methods, `u8` version links:
/// - [count_digits10](#method.count_digits10),
///   [count_digits16](#method.count_digits16).
/// - [digit_at_index10](#method.digit_at_index10)
///  ([*checked*](#method.digit_at_index10_checked)),
///   [digit_at_index16](#method.digit_at_index16)
///  ([*checked*](#method.digit_at_index16_checked)).
/// - [digit_value_at_index10](#method.digit_value_at_index10)
///  ([*checked*](#method.digit_value_at_index10_checked)),
/// - [digit_value_at_index16](#method.digit_value_at_index16)
///  ([*checked*](#method.digit_value_at_index16_checked)),
/// - [digits10](#method.digits10),
///   [digits16](#method.digits16).
/// - [write_digits10](#method.write_digits10).
/// - [digits10_str](#method.digits10_str),
///   [digits16_str](#method.digits16_str).
///
/// Exclusive for `u8`:
/// - [digits10_1](#method.digits10_3),
/// - [digits10_2](#method.digits10_2),
///   [digits16_1](#method.digits16_1).
/// - [write_digits10_omit0](#method.write_digits10_omit0).
/// - [write_digits16](#method.write_digits16),
///  ([*omit0*](#method.write_digits16_omit0)).
///
/// Exclusive for `u16`:
/// - [digits10_3](#method.digits10_3),
///   [digits10_4](#method.digits10_4).
///
/// Exclusive for `u32`, `u64`, `u128` and `usize`:
/// - [write_digits10_fast](#method.write_digits10_fast).
///
/// # Example
/// ```
/// # use devela::{Digits, Slice};
/// let dec = Digits(12345_u32);
/// assert_eq!(dec.digit_at_index10(0), b'5');
/// assert_eq!(dec.digit_at_index10(4), b'1');
/// assert_eq!(dec.digit_value_at_index10(2), 3);
/// assert_eq!(dec.count_digits10(), 5);
/// assert_eq!(dec.digits10(), *b"0000012345");
/// assert_eq!(Slice::trim_leading(&dec.digits10(), b'0'), b"12345");
///
/// let hex = Digits(0x89ABC_u32);
/// assert_eq!(hex.digit_at_index16(1), b'B');
/// assert_eq!(hex.digit_value_at_index16(1), 11);
/// assert_eq!(hex.count_digits16(), 5);
/// assert_eq!(hex.digits16(), *b"00089ABC");
/// assert_eq!(Slice::trim_leading(&hex.digits16(), b'0'), b"89ABC");
/// ```
#[repr(transparent)]
#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Digits<T: Copy>(pub T);