Struct Tpml 

pub struct Tpml<const CAPACITY: usize>(/* private fields */);

A zero-copy TPML wire view over caller-owned bytes.

Implementations

impl<const CAPACITY: usize> Tpml<CAPACITY>

pub fn cast(buf: &[u8]) -> TpmResult<&Self>

Casts a byte slice into a TPML wire view.

Errors

Returns UnexpectedEnd when buf is shorter than the TPML count field. Returns TooManyItems when the declared item count exceeds CAPACITY.

pub fn cast_items<T: TpmCast + ?Sized>(buf: &[u8]) -> TpmResult<&Self>

Casts a byte slice into a typed TPML wire view.

Errors

Returns Err(TpmError) when the TPML header is malformed, the declared count exceeds CAPACITY, or the typed item area is malformed.

pub fn cast_prefix_items<T: TpmCast + ?Sized>( buf: &[u8], ) -> TpmResult<(&Self, &[u8])>

Casts the first typed TPML wire value in a byte slice into a wire view.

Errors

Returns Err(TpmError) when the first typed TPML value is malformed.

pub unsafe fn cast_unchecked(buf: &[u8]) -> &Self

Casts a byte slice into a TPML wire view without validation.

Safety

The caller must ensure that buf starts with a complete TPML count field and that the declared item count does not exceed CAPACITY.

pub fn cast_mut(buf: &mut [u8]) -> TpmResult<&mut Self>

Casts a mutable byte slice into a mutable TPML wire view.

Errors

Returns UnexpectedEnd when buf is shorter than the TPML count field. Returns TooManyItems when the declared item count exceeds CAPACITY.

pub fn cast_items_mut<T: TpmCast + ?Sized>( buf: &mut [u8], ) -> TpmResult<&mut Self>

Casts a mutable byte slice into a typed TPML wire view.

Errors

Returns Err(TpmError) when the TPML header is malformed, the declared count exceeds CAPACITY, or the typed item area is malformed.

pub fn cast_prefix_items_mut<T: TpmCast + ?Sized>( buf: &mut [u8], ) -> TpmResult<(&mut Self, &mut [u8])>

Casts the first mutable typed TPML wire value in a byte slice into a wire view.

Errors

Returns Err(TpmError) when the first typed TPML value is malformed.

pub unsafe fn cast_mut_unchecked(buf: &mut [u8]) -> &mut Self

Casts a mutable byte slice into a mutable TPML wire view without validation.

Safety

The caller must ensure that buf starts with a complete TPML count field and that the declared item count does not exceed CAPACITY. The returned reference inherits the exclusive access represented by buf.

pub const fn as_bytes(&self) -> &[u8]

Returns the complete TPML byte representation.

pub fn as_bytes_mut(&mut self) -> &mut [u8]

Returns the complete mutable TPML byte representation.

pub fn count(&self) -> usize

Returns the declared item count.

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

Returns the bytes after the count field.

pub fn items<T: TpmCast + ?Sized>(&self) -> TpmlIter<'_, T>

Returns an iterator over typed borrowed items.

pub fn items_bytes_mut(&mut self) -> &mut [u8]

Returns the mutable bytes after the count field.

pub const fn len(&self) -> usize

Returns the complete TPML wire length.

pub fn is_empty(&self) -> bool

Returns true when the declared item count is zero.

pub fn validate(buf: &[u8]) -> TpmResult<()>

Validates a TPML header and declared count.

Errors

Returns Err(TpmError) when the count field is missing or exceeds CAPACITY.

pub fn validate_items<T: TpmCast + ?Sized>(buf: &[u8]) -> TpmResult<()>

Validates a typed TPML wire value.

Errors

Returns Err(TpmError) when the TPML header or typed item area is malformed.

pub fn validate_prefix_items<T: TpmCast + ?Sized>( buf: &[u8], ) -> TpmResult<usize>

Validates the first typed TPML wire value and returns its wire length.

Errors

Returns Err(TpmError) when the TPML header or typed item area is malformed.

Trait Implementations

impl<const CAPACITY: usize> AsMut<[u8]> for Tpml<CAPACITY>

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<const CAPACITY: usize> AsRef<[u8]> for Tpml<CAPACITY>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<const CAPACITY: usize> TpmCast for Tpml<CAPACITY>

fn cast(buf: &[u8]) -> TpmResult<&Self>

Casts buf into Self after validating the wire-view invariants.

unsafe fn cast_unchecked(buf: &[u8]) -> &Self

Casts buf into Self without validating the wire-view invariants.

fn cast_prefix(buf: &[u8]) -> TpmResult<(&Self, &[u8])>

Casts the first wire value in buf into Self and returns the remainder.

impl<const CAPACITY: usize> TpmCastMut for Tpml<CAPACITY>

fn cast_mut(buf: &mut [u8]) -> TpmResult<&mut Self>

Casts buf into mutable Self after validating the wire-view invariants.

unsafe fn cast_mut_unchecked(buf: &mut [u8]) -> &mut Self

Casts buf into mutable Self without validating the wire-view invariants.

fn cast_prefix_mut(buf: &mut [u8]) -> TpmResult<(&mut Self, &mut [u8])>

Casts the first mutable wire value in buf into Self and returns the remainder.