Struct RlpList 

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

Borrowed RLP list payload.

Fields are private so downstream crates cannot construct unvalidated decoded values and feed them into trusted re-encoding paths.

Implementations

impl<'a> RlpList<'a>

pub const fn payload(self) -> &'a [u8]

Returns the concatenated encoded child items.

pub const fn encoded_len(self) -> usize

Returns the total encoded list length in bytes.

pub const fn header_len(self) -> usize

Returns the RLP header length in bytes.

pub const fn item_count(self) -> usize

Returns the number of immediate child items.

pub const fn form(self) -> RlpListForm

Returns the canonical list form that was decoded.

pub const fn is_empty(self) -> bool

Returns true when the list has no child items.

pub const fn items(self) -> RlpListItems<'a>

Returns an iterator over the immediate child items in this list.

Nested child list item counts are computed lazily when those child lists are yielded. Recursive callers that walk every nested list can therefore perform additional bounded traversal work proportional to the walked nesting depth. Use Self::items_with_depth_limit when processing externally reachable input with a caller-specific recursion budget.

pub const fn items_with_depth_limit(self, depth: usize) -> RlpListItems<'a>

Returns an iterator that rejects nested lists after depth child-list transitions below this list.

A depth of 0 still permits scalar children but yields DecodeError::NestingTooDeep for a child list. This gives recursive callers an explicit iteration-phase budget independent from decode-time validation.

Trait Implementations

impl<'a> Clone for RlpList<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for RlpList<'a>

impl<'a> Debug for RlpList<'a>

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

Formats the value using the given formatter.

impl Eq for RlpList<'_>

impl PartialEq for RlpList<'_>

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.