Enum ArcPayload 

pub enum ArcPayload {
    Large {
        data: Arc<[u8]>,
        start: usize,
        length: usize,
    },
}

A reference-counted byte payload with slice semantics

ArcPayload provides an efficient way to handle byte data by using Arc<[u8]> for reference counting, combined with offset and length information to represent a slice view of the underlying data. This allows for zero-copy sharing of payload data across multiple consumers while maintaining slice-like semantics.

Variants

Large

Fields

data: Arc<[u8]>

start: usize

length: usize

Implementations

impl ArcPayload

pub fn new(data: Arc<[u8]>, start: usize, length: usize) -> Self

Create a new ArcPayload from reference-counted data with specified range

Creates a new payload that represents a slice view of the provided Arc<[u8]> data starting at the specified offset with the given length.

Parameters

• data - The reference-counted byte data
• start - The starting offset within the data
• length - The length of the payload slice

Panics

Panics in debug mode if start + length > data.len() (payload out of bounds)

Examples

use alloc::sync::Arc;
use mqtt_protocol_core::mqtt::ArcPayload;

let data = Arc::from(&b"hello world"[..]);
let payload = ArcPayload::new(data, 0, 5); // "hello"

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

Get a slice view of the payload data

Returns a byte slice representing the payload data within the specified range.

Returns

A &[u8] slice of the payload data

pub fn len(&self) -> usize

Get the length of the payload

Returns the number of bytes in the payload slice.

Returns

The length of the payload in bytes

pub fn is_empty(&self) -> bool

Check if the payload is empty

Returns true if the payload contains no bytes.

Returns

true if the payload length is zero, false otherwise

pub fn arc_data(&self) -> Option<&Arc<[u8]>>

Get a reference to the underlying Arc<[u8]> data

Returns a reference to the reference-counted byte array that contains the actual data. This provides access to the full underlying data, not just the slice view represented by this payload.

Returns

A reference to the underlying Arc<[u8]> data

Trait Implementations

impl Clone for ArcPayload

fn clone(&self) -> ArcPayload

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArcPayload

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

Formats the value using the given formatter.

impl Default for ArcPayload

fn default() -> Self

Returns the “default value” for a type.

impl IntoPayload for ArcPayload

Identity conversion for ArcPayload (no-op)

fn into_payload(self) -> ArcPayload

Convert the value into an ArcPayload

impl PartialEq for ArcPayload

fn eq(&self, other: &Self) -> 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 Serialize for ArcPayload

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ArcPayload