Struct EventGroupEntry 

pub struct EventGroupEntry<T: AsRef<[u8]>> { /* private fields */ }

Zero-copy wrapper around an EventGroup Entry (16 bytes)

EventGroup entries are used for Subscribe/SubscribeAck messages. They share the same 16-byte structure as Service entries but use different fields for EventGroup ID and counter.

Wire format (16 bytes):

0               1               2               3
0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     Type      |  Index 1st    |  Index 2nd    | # of options  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          Service ID           |         Instance ID           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Major Ver.   |                     TTL                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         Reserved (12)         |Cnt|        EventGroup ID      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Implementations

impl<T: AsRef<[u8]>> EventGroupEntry<T>

pub const LENGTH: usize = 16usize

EventGroup entry wire format size in bytes.

pub fn new_unchecked(buffer: T) -> Self

Create an EventGroupEntry without validation.

Parameters

• buffer - The buffer containing the 16-byte eventgroup entry

Safety

This does not validate buffer length. Use new_checked for validation.

pub fn new_checked(buffer: T) -> Result<Self>

Create an EventGroupEntry from a buffer with length validation.

Parameters

• buffer - The buffer containing the 16-byte eventgroup entry

Returns

• Ok(EventGroupEntry) if buffer is at least 16 bytes
• Err(Error) if buffer is too short

pub fn check_len(&self) -> Result<()>

Validate that the buffer is at least 16 bytes long.

Returns

• Ok(()) if buffer meets minimum length requirement
• Err(Error) if buffer is too short

pub fn check_entry_type(&self) -> Result<()>

Validate the entry has a valid eventgroup entry type.

Returns

• Ok(()) if entry type is Subscribe (0x06) or SubscribeAck (0x07)
• Err(Error::InvalidEntryType) if entry type is invalid for eventgroup entries

pub fn entry_type(&self) -> u8

Get the entry type field (1 byte at offset 0).

Returns

Entry type value (0x06=Subscribe, 0x07=SubscribeAck)

pub fn index_first_option_run(&self) -> u8

Get the index of the first option run (1 byte at offset 1).

Returns

Index into the options array for the first run, or 0 if no options

pub fn index_second_option_run(&self) -> u8

Get the index of the second option run (1 byte at offset 2).

Returns

Index into the options array for the second run, or 0 if no second run

pub fn number_of_options(&self) -> NumberOfOptions

Get the packed number of options (1 byte at offset 3).

Returns

NumberOfOptions containing 4-bit counts for two option runs

pub fn service_id(&self) -> u16

Get the Service ID (2 bytes at offset 4-5, network byte order).

Returns

16-bit Service ID identifying the service

pub fn instance_id(&self) -> u16

Get the Instance ID (2 bytes at offset 6-7, network byte order).

Returns

16-bit Instance ID identifying the service instance

pub fn major_version(&self) -> u8

Get the Major Version (1 byte at offset 8).

Returns

8-bit major version of the service interface

pub fn ttl(&self) -> u32

Get the TTL (Time To Live) field (3 bytes at offset 9-11).

Returns

24-bit TTL in seconds, or 0xFFFFFF for infinite lifetime

pub fn reserved_and_counter(&self) -> ReservedAndCounter

Get the packed reserved and counter field (2 bytes at offset 12-13).

Returns

ReservedAndCounter containing 12-bit reserved field and 4-bit counter

pub fn eventgroup_id(&self) -> u16

Get the EventGroup ID (2 bytes at offset 14-15, network byte order).

Returns

16-bit EventGroup ID identifying the event group

impl<T: AsRef<[u8]> + AsMut<[u8]>> EventGroupEntry<T>

pub fn set_entry_type(&mut self, value: u8)

Set the entry type field (1 byte at offset 0).

Parameters

• value - Entry type value (0x06=Subscribe, 0x07=SubscribeAck)

pub fn set_index_first_option_run(&mut self, value: u8)

Set the index of the first option run (1 byte at offset 1).

Parameters

• value - Index into the options array for the first run

pub fn set_index_second_option_run(&mut self, value: u8)

Set the index of the second option run (1 byte at offset 2).

Parameters

• value - Index into the options array for the second run

pub fn set_number_of_options(&mut self, value: NumberOfOptions)

Set the packed number of options (1 byte at offset 3).

Parameters

• value - NumberOfOptions containing 4-bit counts for two option runs

pub fn set_service_id(&mut self, value: u16)

Set the Service ID (2 bytes at offset 4-5, network byte order).

Parameters

• value - 16-bit Service ID identifying the service

pub fn set_instance_id(&mut self, value: u16)

Set the Instance ID (2 bytes at offset 6-7, network byte order).

Parameters

• value - 16-bit Instance ID identifying the service instance

pub fn set_major_version(&mut self, value: u8)

Set the Major Version (1 byte at offset 8).

Parameters

• value - 8-bit major version of the service interface

pub fn set_ttl(&mut self, value: u32)

Set the TTL (Time To Live) field (3 bytes at offset 9-11).

Parameters

• value - 24-bit TTL in seconds (lower 24 bits used), or 0xFFFFFF for infinite

pub fn set_reserved_and_counter(&mut self, value: ReservedAndCounter)

Set the packed reserved and counter field (2 bytes at offset 12-13).

Parameters

• value - ReservedAndCounter containing 12-bit reserved field and 4-bit counter

pub fn set_eventgroup_id(&mut self, value: u16)

Set the EventGroup ID (2 bytes at offset 14-15, network byte order).

Parameters

• value - 16-bit EventGroup ID identifying the event group

Trait Implementations

impl<T: Clone + AsRef<[u8]>> Clone for EventGroupEntry<T>

fn clone(&self) -> EventGroupEntry<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + AsRef<[u8]>> Debug for EventGroupEntry<T>

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

Formats the value using the given formatter.

impl<T: Copy + AsRef<[u8]>> Copy for EventGroupEntry<T>