Enum ServiceEvent 

#[non_exhaustive]
pub enum ServiceEvent<'a> {
    Question(ServiceQuestion<'a>),
    ProbeConflict(ProbeConflict<'a>),
    HostConflict(HostConflict<'a>),
    KnownAnswer(KnownAnswer<'a>),
}

Events delivered from Endpoint::handle() to a Service.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Question(ServiceQuestion<'a>)

A question targeting this service arrived.

ProbeConflict(ProbeConflict<'a>)

While probing, another peer responded authoritatively for our instance name. The service will auto-rename.

HostConflict(HostConflict<'a>)

While probing, another peer responded authoritatively for our host name (A/AAAA owner). The service will NOT auto-rename — the caller must intervene. See ServiceUpdate::HostConflict.

KnownAnswer(KnownAnswer<'a>)

A known-answer hint from an incoming query — caller may use it for KAS-style suppression of outgoing answers.

Implementations

impl<'a> ServiceEvent<'a>

pub const fn is_question(&self) -> bool

Returns true if this value is of type Question. Returns false otherwise

pub const fn is_probe_conflict(&self) -> bool

Returns true if this value is of type ProbeConflict. Returns false otherwise

pub const fn is_host_conflict(&self) -> bool

Returns true if this value is of type HostConflict. Returns false otherwise

pub const fn is_known_answer(&self) -> bool

Returns true if this value is of type KnownAnswer. Returns false otherwise

impl<'a> ServiceEvent<'a>

pub fn unwrap_question(self) -> ServiceQuestion<'a>

Unwraps this value to the ServiceEvent::Question variant. Panics if this value is of any other type.

pub fn unwrap_question_ref(&self) -> &ServiceQuestion<'a>

Unwraps this reference to the ServiceEvent::Question variant. Panics if this value is of any other type.

pub fn unwrap_probe_conflict(self) -> ProbeConflict<'a>

Unwraps this value to the ServiceEvent::ProbeConflict variant. Panics if this value is of any other type.

pub fn unwrap_probe_conflict_ref(&self) -> &ProbeConflict<'a>

Unwraps this reference to the ServiceEvent::ProbeConflict variant. Panics if this value is of any other type.

pub fn unwrap_host_conflict(self) -> HostConflict<'a>

Unwraps this value to the ServiceEvent::HostConflict variant. Panics if this value is of any other type.

pub fn unwrap_host_conflict_ref(&self) -> &HostConflict<'a>

Unwraps this reference to the ServiceEvent::HostConflict variant. Panics if this value is of any other type.

pub fn unwrap_known_answer(self) -> KnownAnswer<'a>

Unwraps this value to the ServiceEvent::KnownAnswer variant. Panics if this value is of any other type.

pub fn unwrap_known_answer_ref(&self) -> &KnownAnswer<'a>

Unwraps this reference to the ServiceEvent::KnownAnswer variant. Panics if this value is of any other type.

impl<'a> ServiceEvent<'a>

pub fn try_unwrap_question( self, ) -> Result<ServiceQuestion<'a>, TryUnwrapError<Self>>

Attempts to unwrap this value to the ServiceEvent::Question variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_question_ref( &self, ) -> Result<&ServiceQuestion<'a>, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ServiceEvent::Question variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_probe_conflict( self, ) -> Result<ProbeConflict<'a>, TryUnwrapError<Self>>

Attempts to unwrap this value to the ServiceEvent::ProbeConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_probe_conflict_ref( &self, ) -> Result<&ProbeConflict<'a>, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ServiceEvent::ProbeConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_host_conflict( self, ) -> Result<HostConflict<'a>, TryUnwrapError<Self>>

Attempts to unwrap this value to the ServiceEvent::HostConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_host_conflict_ref( &self, ) -> Result<&HostConflict<'a>, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ServiceEvent::HostConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_known_answer( self, ) -> Result<KnownAnswer<'a>, TryUnwrapError<Self>>

Attempts to unwrap this value to the ServiceEvent::KnownAnswer variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_known_answer_ref( &self, ) -> Result<&KnownAnswer<'a>, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ServiceEvent::KnownAnswer variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

Trait Implementations

impl<'a> Clone for ServiceEvent<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ServiceEvent<'a>

impl<'a> Debug for ServiceEvent<'a>

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

Formats the value using the given formatter.