mdns-proto 0.2.0

Sans-I/O mDNS protocol state machines (no_std, no_alloc capable, panic-free).
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

//! AAAA record (IPv6 address, RFC 3596).

use core::net::Ipv6Addr;

use crate::error::{BufferTooShortDetail, ParseError};

/// Parsed AAAA record rdata.
#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
// `AAAA` is the canonical DNS record-type name; keep the verbatim spelling.
#[allow(clippy::upper_case_acronyms)]
pub struct AAAA {
  addr: Ipv6Addr,
}

impl AAAA {
  /// Parses a 16-byte IPv6 address from rdata.
  ///
  /// `rdata` MUST be exactly 16 bytes (RFC 3596 ยง2.2).  An
  /// oversize slice would previously have been silently truncated.
  pub fn try_from_rdata(rdata: &[u8]) -> Result<Self, ParseError> {
    if rdata.len() != 16 {
      return Err(ParseError::BufferTooShort(BufferTooShortDetail::new(
        16,
        0,
        rdata.len(),
      )));
    }
    let arr: &[u8; 16] = rdata
      .first_chunk::<16>()
      .ok_or_else(|| ParseError::BufferTooShort(BufferTooShortDetail::new(16, 0, rdata.len())))?;
    Ok(Self {
      addr: Ipv6Addr::from(*arr),
    })
  }

  /// Returns the parsed IPv6 address.
  #[inline(always)]
  pub const fn addr(&self) -> Ipv6Addr {
    self.addr
  }
}

#[cfg(test)]
#[allow(clippy::unwrap_used)]
mod tests;