Struct ContainerIndex 

pub struct ContainerIndex {
    pub root: String,
    pub entries: Vec<ContainerEntry>,
}

容器目录索引。

Fields

root: String

原始根目录名，仅用于显示。

entries: Vec<ContainerEntry>

全部条目。

Implementations

impl ContainerIndex

pub fn new(root: impl Into<String>) -> Self

新建空索引。

pub fn total_size(&self) -> u64

文件条目总字节数——即容器明文载荷的长度。

pub fn file_count(&self) -> usize

文件条目数量。

pub fn find(&self, display_path: &str) -> Option<&ContainerEntry>

按显示路径查找条目。

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

编码为 TLV_FOLDER_INDEX 的明文内容。

自定义紧凑二进制格式而非 JSON：索引可能上到 10 MB 量级， 且要在移动端解析，避免文本格式的体积与解析开销。

布局：

u16  version
u16  root_len       root 的 UTF-8 字节数
u32  entry_count
...  root 字节
每个条目：
  u8   kind
  u8   flags        bit0=有 hash, bit1=有 target, bit2=有 meta
  u16  component_count
  u64  offset
  u64  size
  每个组件： u16 len + 字节
  [hash 32B]
  [u16 target_len + 字节]
  [meta 块]

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

从 TLV_FOLDER_INDEX 的明文内容解析。

同时完成路径安全校验与载荷区间自洽性检查——不把这些留给调用方。

Errors

输入畸形、路径不安全、区间越界或声明长度与实际不符时返回 [bad]。

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

校验文件条目的载荷区间首尾相接、无重叠、无空洞。

容器载荷是顺序拼接，任何重叠都意味着索引被篡改或实现有误。

Errors

区间不连续或路径重复时返回 [bad]。

Trait Implementations

impl Clone for ContainerIndex

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 ContainerIndex

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

Formats the value using the given formatter.

impl Default for ContainerIndex

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ContainerIndex

impl PartialEq for ContainerIndex

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContainerIndex