Struct MacAddr6

pub struct MacAddr6(/* private fields */);

MAC address, represented as EUI-48

Implementations

impl MacAddr6

pub const fn new(eui: [u8; 6]) -> Self

pub fn random() -> Self

Available on crate feature rand only.

pub const fn broadcast() -> Self

pub const fn nil() -> Self

pub fn set_local(&mut self, v: bool)

Sets locally administered flag

pub const fn is_local(&self) -> bool

Returns the state of locally administered flag

pub fn set_multicast(&mut self, v: bool)

Sets multicast flag

pub const fn is_multicast(&self) -> bool

Returns the state of multicast flag

pub const fn oui(&self) -> [u8; 3]

Returns organizationally unique identifier (OUI) of this MAC address

pub fn set_oui(&mut self, oui: [u8; 3])

Sets organizationally unique identifier (OUI) for this MAC address

pub const fn to_array(self) -> [u8; 6]

Returns internal array representation for this MAC address, consuming it

pub const fn as_slice(&self) -> &[u8]

Returns internal array representation for this MAC address as u8 slice

pub fn as_mut_slice(&mut self) -> &mut [u8]

Returns internal array representation for this MAC address as mutable u8 slice

pub const fn as_c_slice(&self) -> &[c_char]

Returns internal array representation for this MAC address as core::ffi::c_char slice. This can be useful in parsing ifr_hwaddr, for example.

pub const fn parse_str(s: &str) -> Result<Self, ParseError>

Parse MAC address from string and return it as MacAddr. This function can be used in const context, so MAC address can be parsed in compile-time.

pub fn format_write<T: Write>(&self, f: &mut T, format: MacAddrFormat) -> Result

Write MAC address to impl core::fmt::Write, which can be used in no_std environments.

It can be used like this with arrayvec::ArrayString without allocations:

use arrayvec::ArrayString;
use advmac::{MacAddr6, MacAddrFormat, MAC_CANONICAL_SIZE6};

let mac = MacAddr6::parse_str("AA:BB:CC:DD:EE:FF").unwrap();

let mut buf = ArrayString::<MAC_CANONICAL_SIZE6>::new();
mac.format_write(&mut buf, MacAddrFormat::Canonical).unwrap();

pub fn format_string(&self, format: MacAddrFormat) -> String

Available on crate feature std only.

Write MAC address to String. This function uses Self::format_write internally and produces the same result, but in string form, which can be convenient in non-constrainted environments.

impl MacAddr6

pub const fn to_modified_eui64(self) -> MacAddr8

pub const fn try_from_modified_eui64(eui64: MacAddr8) -> Result<Self, IpError>

pub const fn to_link_local_ipv6(self) -> Ipv6Addr

Available on crate feature std only.

pub const fn try_from_link_local_ipv6(ip: Ipv6Addr) -> Result<Self, IpError>

Available on crate feature std only.

pub const fn try_from_multicast_ipv4(ip: Ipv4Addr) -> Result<Self, IpError>

Available on crate feature std only.

pub const fn try_from_multicast_ipv6(ip: Ipv6Addr) -> Result<Self, IpError>

Available on crate feature std only.

pub const fn try_from_multicast_ip(ip: IpAddr) -> Result<Self, IpError>

Available on crate feature std only.

Trait Implementations

impl Clone for MacAddr6

fn clone(&self) -> MacAddr6

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MacAddr6

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MacAddr6

fn default() -> MacAddr6

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MacAddr6

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for MacAddr6

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<[u8; 6]> for MacAddr6

fn from(arr: [u8; 6]) -> Self

Converts to this type from the input type.

impl FromStr for MacAddr6

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for MacAddr6

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for MacAddr6

fn cmp(&self, other: &MacAddr6) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for MacAddr6

fn eq(&self, other: &MacAddr6) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for MacAddr6

fn partial_cmp(&self, other: &MacAddr6) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for MacAddr6

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl TryFrom<&[i8]> for MacAddr6

Available on non-AArch64 only.

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: &[c_char]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&[u8]> for MacAddr6

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&str> for MacAddr6

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for MacAddr6

Available on crate feature std only.

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for MacAddr6

impl Eq for MacAddr6

impl StructuralPartialEq for MacAddr6