为什么？

JSON是一个非常宽松的格式，几乎什么都可以 - 数组可以包含混合类型，对象键可以在API调用之间更改类型或在某些条件下不包括某些键。将此映射到惯用的Rust结构体引入了摩擦。

此crate旨在避免这种摩擦。

let parsed = jzon::parse(r#"

{
    "code": 200,
    "success": true,
    "payload": {
        "features": [
            "awesome",
            "easyAPI",
            "lowLearningCurve"
        ]
    }
}

"#).unwrap();

let instantiated = object!{
    // quotes on keys are optional
    "code": 200,
    success: true,
    payload: {
        features: [
            "awesome",
            "easyAPI",
            "lowLearningCurve"
        ]
    }
};

assert_eq!(parsed, instantiated);

一等公民

使用宏和索引，轻松处理数据。

let mut data = object!{
    foo: false,
    bar: null,
    answer: 42,
    list: [null, "world", true]
};

// Partial equality is implemented for most raw types:
assert!(data["foo"] == false);

// And it's type aware, `null` and `false` are different values:
assert!(data["bar"] != false);

// But you can use any Rust number types:
assert!(data["answer"] == 42);
assert!(data["answer"] == 42.0);
assert!(data["answer"] == 42isize);

// Access nested structures, arrays and objects:
assert!(data["list"][0].is_null());
assert!(data["list"][1] == "world");
assert!(data["list"][2] == true);

// Error resilient - accessing properties that don't exist yield null:
assert!(data["this"]["does"]["not"]["exist"].is_null());

// Mutate by assigning:
data["list"][0] = "Hello".into();

// Use the `dump` method to serialize the data:
assert_eq!(data.dump(), r#"{"foo":false,"bar":null,"answer":42,"list":["Hello","world",true]}"#);

// Or pretty print it out:
println!("{:#}", data);

安装

只需将其添加到您的Cargo.toml文件中

[dependencies]
jzon = "*"

然后在您的main.rs / lib.rs文件中导入它

#[macro_use]
extern crate jzon;

性能和一致性

这里曾经有一段话说明性能不是此crate的主要目标。它现在绝对是其中之一。

虽然此crate不提供将JSON解析到原生Rust结构体的方法，但它为DOM解析、字符串化和操作进行了大量优化。它在基准测试中表现良好，在某些情况下甚至可以超越解析到结构体的性能。

此crate根据 RFC 7159和ECMA-404文档实现标准。为了实现最佳互操作性，浮点数以64位精度尾数和16位指数的形式存储。

许可证

此crate根据MIT许可证和Apache许可证（版本2.0）的条款分发。选择最适合您的任何一个。

有关详细信息，请参阅LICENSE-APACHE和LICENSE-MIT。