Struct MacAddress 

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

A 48-bit IEEE 802 MAC address, stored as six octets.

parse accepts the common aa:bb:cc:dd:ee:ff and aa-bb-cc-dd-ee-ff text forms (one consistent separator, lower- or upper-case hex). The type is allocation-free and no_std; Display always renders the canonical lowercase, colon-separated form.

Implementations

impl MacAddress

pub const fn from_octets(octets: [u8; 6]) -> Self

Builds a MAC address directly from six octets. Always valid.

pub fn parse(value: &str) -> PrimitiveResult<Self>

Parses a MAC address in aa:bb:cc:dd:ee:ff or aa-bb-cc-dd-ee-ff form.

The separator must be : or - and the same throughout. Returns an error for an empty string, the wrong length, an inconsistent separator, or a non-hex octet.

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

Returns the six octets.

pub const fn is_multicast(&self) -> bool

Returns true if this is a multicast address (low bit of the first octet set).

pub const fn is_unicast(&self) -> bool

Returns true if this is a unicast address.

pub const fn is_local(&self) -> bool

Returns true if this address is locally administered (second-lowest bit of the first octet set), as opposed to a universally administered (OUI) address.

pub const fn is_universal(&self) -> bool

Returns true if this address is universally administered.

Trait Implementations

impl Clone for MacAddress

fn clone(&self) -> MacAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MacAddress

impl Debug for MacAddress

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

Formats the value using the given formatter.

impl Display for MacAddress

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

Formats the value using the given formatter.

impl Eq for MacAddress

impl From<MacAddress> for [u8; 6]

fn from(mac: MacAddress) -> Self

Converts to this type from the input type.

impl From<[u8; 6]> for MacAddress

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

Converts to this type from the input type.

impl FromStr for MacAddress

type Err = PrimitiveError

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 MacAddress

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 MacAddress

fn cmp(&self, other: &MacAddress) -> 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 MacAddress

fn eq(&self, other: &MacAddress) -> 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 MacAddress

fn partial_cmp(&self, other: &MacAddress) -> 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 StructuralPartialEq for MacAddress

impl TryFrom<&str> for MacAddress

type Error = PrimitiveError

The type returned in the event of a conversion error.

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

Performs the conversion.