Struct TlvSet 

pub struct TlvSet { /* private fields */ }

TLV 区的集合。保留原始顺序，以便重写文件时保持字节稳定。

Implementations

impl TlvSet

pub const fn new() -> Self

空集合。

pub fn push(&mut self, e: TlvEntry) -> &mut Self

追加条目。

pub fn entries(&self) -> &[TlvEntry]

全部条目。

pub fn len(&self) -> usize

条目数量。

pub fn is_empty(&self) -> bool

是否为空。

pub fn find(&self, tlv_type: u16) -> Option<&TlvEntry>

按类型查找第一个条目。

pub fn encoded_len(&self) -> usize

编码后的总字节数。

pub fn parse(data: &[u8]) -> Result<Self>

解析 TLV 区。

只做结构解析，不检查未知 CRITICAL 类型——那需要在 MAC 验证通过之后再做， 见 TlvSet::check_critical。

条目数受 parse_limits::MAX_TLV_ENTRIES 限制，防止大量零长度条目耗尽内存。

Errors

• Error::Truncated：长度字段越界或数据截断
• Error::MalformedTlv：条目数超过上限

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

检查是否存在未知且 CRITICAL 的条目。

规范 §9 步骤 7 要求此时拒绝打开文件。私有区间（≥ 0x8000）的未知类型即使标记 CRITICAL 也应忽略，因为那是第三方实现的自用字段。

Errors

存在未知 CRITICAL 条目时返回 Error::UnknownCriticalTlv。

pub fn to_bytes(&self) -> Vec<u8>

序列化。

pub fn decrypt_value( &self, tlv_type: u16, fek: &Fek, cipher: CipherId, ) -> Result<Vec<u8>>

解密某个加密条目的 value。

Errors

• Error::MissingTlv：条目不存在
• Error::MalformedTlv：条目未标记 ENCRYPTED，或解密认证失败

Trait Implementations

impl Clone for TlvSet

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TlvSet

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

Formats the value using the given formatter.

impl Default for TlvSet

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TlvSet

impl PartialEq for TlvSet

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TlvSet