Struct IdentityRequestFilters 

pub struct IdentityRequestFilters<'a> { /* private fields */ }

Interprets the option block of an MacCommand::IdentityRequest.

Borrows the raw block and decodes its identity_filter options on demand. A responder uses nonce to obtain the correlation value it must echo, and selects to decide whether it is a target of the request.

Implementations

impl<'a> IdentityRequestFilters<'a>

pub fn new(options: &'a [u8]) -> Self

Wrap the option block carried by an Identity Request.

pub fn nonce(&self) -> Result<Option<u32>, AppParseError>

The correlation nonce the responder must echo into its identity’s Nonce option, or None if the request carried no NONCE option.

Returns the first NONCE option; tolerates minimal (≤4 byte) encodings.

pub fn hint_filtered(&self) -> bool

Whether the request carries at least one FILTER_NODE_HINT filter.

A hint filter names a single node, so such a request solicits one reply however far it travels. Without one the request selects by role or capability and every node it reaches may answer, which is what confines a broadcast or multicast solicitation — and its replies — to the requester’s own neighbourhood.

A malformed option block reads as unfiltered, which is the conservative answer: it keeps the strict rules in force.

pub fn selects( &self, role: NodeRole, capabilities: NodeCapabilities, hint: &NodeHint, ) -> Result<bool, AppParseError>

Whether a node with the given identity is selected by this request.

Filters combine as a logical AND across distinct filter types and a logical OR among repeated filters of the same type. An unknown critical option (odd key) excludes the node; unknown elective options are ignored. A well-formed request with no filters (a unicast request) selects every node.

Trait Implementations

impl<'a> Clone for IdentityRequestFilters<'a>

fn clone(&self) -> IdentityRequestFilters<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for IdentityRequestFilters<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for IdentityRequestFilters<'a>