Struct Path 

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

设备树节点路径。

Implementations

impl Path<'_>

pub fn level(&self) -> usize

返回路径层数。定义根节点的子节点层数为 0。

Examples found in repository

examples/qemu-virt.rs (line 25)

fn main() {
    let mut aligned = vec![0usize; DEVICE_TREE.len() / core::mem::size_of::<usize>()];
    unsafe {
        aligned
            .as_mut_ptr()
            .copy_from_nonoverlapping(DEVICE_TREE.as_ptr() as _, aligned.len());
    }

    let dtb = unsafe {
        Dtb::from_raw_parts_filtered(aligned.as_ptr() as _, |e| {
            matches!(
                e,
                HeaderError::Misaligned(4) | HeaderError::LastCompVersion(16)
            )
        })
    }
    .unwrap();
    dtb.walk(|path, obj| match obj {
        DtbObj::SubNode { name } => {
            println!("{}{path}/{}", indent(path.level(), INDENT_WIDTH), unsafe {
                core::str::from_utf8_unchecked(name)
            });
            WalkOperation::StepInto
        }
        DtbObj::Property(prop) => {
            let indent = indent(path.level(), INDENT_WIDTH);
            println!("{indent}{prop:?}");
            WalkOperation::StepOver
        }
    });
    println!("ok");
}

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

返回路径最后一级的节点名。

pub fn join(&self, buf: &mut [u8]) -> Result<usize, usize>

将路径字符串格式化到 buf 中。

如果返回 Ok(n)，表示字符串长度为 n（n 不大于 buf.len()）。 如果返回 Err(n)，表示缓冲区长度无法存放整个字符串，实现保证 n 等于 buf.len()。

Trait Implementations

impl Display for Path<'_>

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

Formats the value using the given formatter.