Enum serde_json_borrow::Value

pub enum Value<'ctx> {
    Null,
    Bool(bool),
    Number(Number),
    Str(Cow<'ctx, str>),
    Array(Vec<Value<'ctx>>),
    Object(ObjectAsVec<'ctx>),
}

Represents any valid JSON value.

Example

use std::io;
use serde_json_borrow::Value;
fn main() -> io::Result<()> {
    let data = r#"{"bool": true, "key": "123"}"#;
    let value: Value = serde_json::from_str(&data)?;
    assert_eq!(value.get("bool"), &Value::Bool(true));
    assert_eq!(value.get("key"), &Value::Str("123".into()));
    Ok(())
}

Variants

Null

Represents a JSON null value.

let v = Value::Null;

Bool(bool)

Represents a JSON boolean.

let v = Value::Bool(true);

Number(Number)

Represents a JSON number, whether integer or floating point.

let v = Value::Number(12.5.into());

Str(Cow<'ctx, str>)

Represents a JSON string.

let v = Value::Str("ref".into());

Array(Vec<Value<'ctx>>)

Represents a JSON array.

Object(ObjectAsVec<'ctx>)

Represents a JSON object.

By default the map is backed by a Vec. Allows very fast deserialization. Ideal when wanting to iterate over the values, in contrast to look up by key.

let v = Value::Object(ObjectAsVec([("key", Value::Str("value".into()))].into_iter().collect()));

Implementations

impl<'ctx> Value<'ctx>

pub fn get<I: Index<'ctx>>(&'ctx self, index: I) -> &'ctx Value<'ctx>

Index into a serde_json_borrow::Value using the syntax value.get(0) or value.get("k").

Returns Value::Null if the type of self does not match the type of the index, for example if the index is a string and self is an array or a number. Also returns Value::Null if the given key does not exist in the map or the given index is not within the bounds of the array.

Examples

let json_obj = r#"
{
    "x": {
        "y": ["z", "zz"]
    }
}
"#;

let data: Value = serde_json::from_str(json_obj).unwrap();

assert_eq!(data.get("x").get("y").get(0), &Value::Str("z".into()));
assert_eq!(data.get("x").get("y").get(1), &Value::Str("zz".into()));
assert_eq!(data.get("x").get("y").get(2), &Value::Null);

assert_eq!(data.get("a"), &Value::Null);
assert_eq!(data.get("a").get("b"), &Value::Null);

pub fn is_null(&self) -> bool

Returns true if Value is Value::Null.

pub fn is_array(&self) -> bool

Returns true if Value is Value::Array.

pub fn is_object(&self) -> bool

Returns true if Value is Value::Object.

pub fn is_bool(&self) -> bool

Returns true if Value is Value::Bool.

pub fn is_number(&self) -> bool

Returns true if Value is Value::Number.

pub fn is_string(&self) -> bool

Returns true if Value is Value::Str.

pub fn is_i64(&self) -> bool

Returns true if the Value is an integer between i64::MIN and i64::MAX. For any Value on which is_i64 returns true, as_i64 is guaranteed to return the integer value.

pub fn is_u64(&self) -> bool

Returns true if the Value is an integer between zero and u64::MAX. For any Value on which is_u64 returns true, as_u64 is guaranteed to return the integer value.

pub fn is_f64(&self) -> bool

Returns true if the Value is a f64 number.

pub fn iter_array(&self) -> Option<impl Iterator<Item = &Value<'_>>>

If the Value is an Array, returns an iterator over the elements in the array.

pub fn iter_object(&self) -> Option<impl Iterator<Item = (&str, &Value<'_>)>>

If the Value is an Object, returns an iterator over the elements in the object.

pub fn as_array(&self) -> Option<&[Value<'_>]>

If the Value is an Array, returns the associated Array. Returns None otherwise.

pub fn as_object(&self) -> Option<&ObjectAsVec<'_>>

If the Value is an Object, returns the associated Object. Returns None otherwise.

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

If the Value is a Boolean, returns the associated bool. Returns None otherwise.

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

If the Value is a String, returns the associated str. Returns None otherwise.

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

If the Value is an integer, represent it as i64 if possible. Returns None otherwise.

pub fn as_u64(&self) -> Option<u64>

If the Value is an integer, represent it as u64 if possible. Returns None otherwise.

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

If the Value is a number, represent it as f64 if possible. Returns None otherwise.

Trait Implementations

impl<'ctx> Clone for Value<'ctx>

fn clone(&self) -> Value<'ctx>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'ctx> Debug for Value<'ctx>

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value<'de>

fn deserialize<D>(deserializer: D) -> Result<Value<'de>, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'ctx> From<Value<'ctx>> for Value

fn from(val: Value<'_>) -> Self

Converts to this type from the input type.

impl<'ctx> PartialEq for Value<'ctx>

fn eq(&self, other: &Value<'ctx>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'ctx> Serialize for Value<'ctx>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'ctx> Eq for Value<'ctx>

impl<'ctx> StructuralPartialEq for Value<'ctx>