rws-base 18.27.0

The base layer of rust-web-server (internal: use the rust-web-server crate).
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

#[cfg(test)]
mod tests;

/// An unsigned integer as decimal text in a stack buffer — for numbers
/// written on every request (sizes, timestamps, status codes), where
/// `to_string()`/`format!` cost a trip through the formatting machinery and
/// a heap allocation each.
#[doc(hidden)]
pub struct Decimal {
    digits: [u8; 39],
    start: usize,
}

impl Decimal {
    #[doc(hidden)]
    pub fn new(n: u128) -> Decimal {
        let mut decimal = Decimal { digits: [0; 39], start: 39 };
        // u128 division is a library call; nanosecond timestamps fit a u64
        // until 2554, so take the fast path whenever the value does.
        match u64::try_from(n) {
            Ok(mut n) => loop {
                decimal.start -= 1;
                decimal.digits[decimal.start] = b'0' + (n % 10) as u8;
                n /= 10;
                if n == 0 {
                    break;
                }
            },
            Err(_) => {
                let mut n = n;
                loop {
                    decimal.start -= 1;
                    decimal.digits[decimal.start] = b'0' + (n % 10) as u8;
                    n /= 10;
                    if n == 0 {
                        break;
                    }
                }
            }
        }
        decimal
    }

    #[doc(hidden)]
    pub fn as_str(&self) -> &str {
        // Only ASCII digits are ever written.
        std::str::from_utf8(&self.digits[self.start..]).unwrap_or("")
    }
}