Enum OwnedDataValue

Source

pub enum OwnedDataValue {
    Null,
    Bool(bool),
    Number(NumberValue),
    String(String),
    Array(Vec<OwnedDataValue>),
    Object(Vec<(String, OwnedDataValue)>),
}

Expand description

Heap-owned JSON value tree. Variants mirror DataValue one-for-one; no lifetime parameter.

Variants§

§

Object(Vec<(String, OwnedDataValue)>)

Implementations§

Source §

impl OwnedDataValue

Source

pub fn write_json_into(&self, out: &mut Vec<u8>)

Append the compact JSON encoding of this value to out. See DataValue::write_json_into; this is the owned-side mirror.

Source

pub fn pretty(&self) -> Pretty<'_, OwnedDataValue>

Pretty-print wrapper; see DataValue::pretty.

use datavalue_rs::OwnedDataValue;

let v: OwnedDataValue = r#"{"a":1}"#.parse().unwrap();
assert_eq!(v.pretty().to_string(), "{\n  \"a\": 1\n}");

Source

pub fn write_json_pretty_into(&self, out: &mut Vec<u8>)

Append the pretty JSON encoding of this value to out.

Source §

Parse JSON into an OwnedDataValue. Internally parses into a throwaway arena (using the fast hand-rolled parser) and deep-clones the result out — so JSON parsing speed matches DataValue::from_str, minus the deep-clone tail.

Also available via the std::str::FromStr trait.

Source

pub fn is_null(&self) -> bool

Source

pub fn is_bool(&self) -> bool

Source

pub fn is_number(&self) -> bool

Source

pub fn is_i64(&self) -> bool

Source

pub fn is_f64(&self) -> bool

Source

pub fn is_string(&self) -> bool

Source

pub fn is_array(&self) -> bool

Source

pub fn is_object(&self) -> bool

Source

pub fn as_bool(&self) -> Option<bool>

Source

pub fn as_i64(&self) -> Option<i64>

Source

pub fn as_f64(&self) -> Option<f64>

Source

pub fn as_number(&self) -> Option<&NumberValue>

Source

pub fn as_str(&self) -> Option<&str>

Source

pub fn as_array(&self) -> Option<&[OwnedDataValue]>

Source

pub fn as_object(&self) -> Option<&[(String, OwnedDataValue)]>

Source

pub fn get<I: OwnedValueIndex>(&self, index: I) -> Option<&OwnedDataValue>

serde_json::Value::get-style lookup.

Source

pub fn len(&self) -> Option<usize>

Source

pub fn is_empty(&self) -> Option<bool>

Source

pub fn members(&self) -> Iter<'_, OwnedDataValue>

Iterate array items. Returns an empty iterator if self is not an array.

Source

pub fn entries(&self) -> OwnedEntriesIter<'_>

Iterate object entries as (key, value) pairs in insertion order. Returns an empty iterator if self is not an object.

Source

pub fn to_json_string(&self) -> String

Serialise to a compact JSON string. Equivalent to format!("{self}") / self.to_string() — provided as the conventional name people reach for, and so callers don’t have to import std::fmt::Write.

Source

pub fn to_arena<'a>(&self, arena: &'a Bump) -> DataValue<'a>

Borrow this owned tree into the given arena, returning a DataValue view. Strings are arena-allocated copies.

Array/Object use alloc_slice_fill_with rather than bumpalo::Vec::with_capacity_in + push: one pre-sized arena allocation and a tight write loop, skipping the Vec wrapper’s per-push capacity check and the Layout::array validation that RawVec::allocate_in re-runs for each nested allocation.

Source §

impl OwnedDataValue

Source

pub fn from_i64(i: i64) -> Self

Source

pub fn from_f64(f: f64) -> Self

Source

pub fn array<I, V>(items: I) -> Self
where I: IntoIterator<Item = V>, V: Into<OwnedDataValue>,

Build an OwnedDataValue::Array from anything iterable into values that already convert into OwnedDataValue (covers all the existing From<bool|i64|f64|String|&str|...> impls).

use datavalue_rs::OwnedDataValue;
let v = OwnedDataValue::array([1, 2, 3]);
assert_eq!(v[0].as_i64(), Some(1));
let v = OwnedDataValue::array(["a", "b"]);
assert_eq!(v[1].as_str(), Some("b"));

Source

pub fn object<I, K, V>(pairs: I) -> Self
where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<OwnedDataValue>,

Build an OwnedDataValue::Object from (key, value) pairs.

use datavalue_rs::OwnedDataValue;
let v = OwnedDataValue::object([("type", "NaN"), ("op", "+")]);
assert_eq!(v["type"].as_str(), Some("NaN"));
let v = OwnedDataValue::object([("count", 42)]);
assert_eq!(v["count"].as_i64(), Some(42));

Trait Implementations§

Source §

impl Clone for OwnedDataValue

Source §

fn clone(&self) -> OwnedDataValue

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

Source §

impl Debug for OwnedDataValue

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Default for OwnedDataValue

Source §

fn default() -> OwnedDataValue

Returns the “default value” for a type. Read more

Source §

impl Display for OwnedDataValue

Source §

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

Compact JSON. Same shape as serde_json::to_string.

use datavalue_rs::OwnedDataValue;

let v: OwnedDataValue = r#"{"a":[1,2.5,"hi"]}"#.parse().unwrap();
assert_eq!(v.to_string(), r#"{"a":[1,2.5,"hi"]}"#);

Source §