wtx 0.44.1

A collection of different transport implementations and related tools focused primarily on web technologies.
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

use crate::{
  calendar::CalendarError,
  codec::{I16String, i16_string_pad},
  misc::AsciiGraphic,
};

/// All possible years that can be represented by the system. Goes from -32767 to 32767.
#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
pub struct Year(i16);

impl Year {
  /// Instance that refers the common era (0001).
  pub const CE: Self = Self(1);
  /// Instance that refers the UNIX epoch (1970).
  pub const EPOCH: Self = Self(1970);
  /// Instance with the maximum allowed value of `32767`
  pub const MAX: Self = Self(32767);
  /// Instance with the minimum allowed value of `-32767`
  pub const MIN: Self = Self(-32767);

  /// Creates a new instance from a valid `num` number.
  #[inline]
  pub const fn from_num(num: i16) -> Result<Self, CalendarError> {
    if num < Self::MIN.num() || num > Self::MAX.num() {
      return Err(CalendarError::InvalidYear { received: num });
    }
    Ok(Self(num))
  }

  /// If this instance has an additional day.
  #[inline]
  pub const fn is_leap_year(self) -> bool {
    let value = if self.0 % 100 == 0 { 0b1111 } else { 0b0011 };
    self.0 & value == 0
  }

  /// Constant unary negation
  #[allow(clippy::arithmetic_side_effects, reason = "constructors don't allow -32768")]
  #[inline]
  #[must_use]
  pub const fn neg(self) -> Self {
    Self(-self.0)
  }

  /// Integer representation
  #[inline]
  pub const fn num(self) -> i16 {
    self.0
  }

  /// String representation
  #[inline]
  pub fn num_str(self) -> I16String {
    i16_string_pad(self.0, AsciiGraphic::ZERO, 4)
  }
}

impl TryFrom<i16> for Year {
  type Error = crate::Error;

  #[inline]
  fn try_from(from: i16) -> Result<Self, Self::Error> {
    Ok(Self::from_num(from)?)
  }
}