#stack-frame #linked-list #along #intended #chained #singly #no-alloc

无需 std stackstack

一个旨在在堆栈帧中链式连接的单链表

4 个版本 (2 个重大更改)

0.3.0 2024 年 7 月 12 日
0.2.0 2024 年 7 月 10 日
0.1.1 2024 年 7 月 10 日
0.1.0 2024 年 7 月 10 日

#478 in Rust 模式

Download history 141/week @ 2024-07-06 151/week @ 2024-07-13 379/week @ 2024-07-20 222/week @ 2024-07-27

893 每月下载量

MIT/Apache

19KB
286

一个旨在在(程序)堆栈帧中链式连接的单链表。

这对于访问者和递归函数很有用。

示例:JSON 访问者


enum Path<'a> {
    Key(&'a str),
    Index(usize),
}

impl std::fmt::Display for Path<'_> { ... }

/// Recursively visit JSON strings, recording their path and contents
fn collect_strs<'a>(
    v: &mut Vec<(String, &'a str)>,
    path: stackstack::Stack<Path>,
    //                ^^^^^^^^^^^ shared across recursive calls
    json: &'a serde_json::Value,
) {
    match json {
        Value::String(it) => v.push((itertools::join(&path, "."), it)),
        //    iterate the path to the current node ~~^
        Value::Array(arr) => {
            for (ix, child) in arr.iter().enumerate() {
                collect_strs(v, path.pushed(Path::Index(ix)), child)
                //              ^~~ recurse with an appended path
            }
        }
        Value::Object(obj) => {
            for (k, child) in obj {
                collect_strs(v, path.pushed(Path::Key(k)), child)
                //                          ^~~ the new node is allocated on
                //                              the current (program) stack frame
            }
        },
        _ => {}
    }
}

let mut v = vec![];
let json = json!({
    "mary": {
        "had": [
            {"a": "little lamb"},
            {"two": "yaks"}
        ]
    }
});
collect_strs(&mut v, Stack::new(), &json);
assert_eq! { v, [
    ("mary.had.0.a".into(), "little lamb"),
    ("mary.had.1.two".into(), "yaks")
]}

无运行时依赖