Enum serde_json::value::Value

pub enum Value {
    Null,
    Bool(bool),
    I64(i64),
    U64(u64),
    F64(f64),
    String(String),
    Array(Vec<Value>),
    Object(BTreeMap<String, Value>),
}

Represents a JSON value

Variants

Null

Represents a JSON numm value

Bool(bool)

Represents a JSON array

I64(i64)

Represents a JSON signed integer

U64(u64)

Represents a JSON unsigned integer

F64(f64)

Represents a JSON floating point number

String(String)

Represents a JSON string

Array(Vec<Value>)

Represents a JSON array

Object(BTreeMap<String, Value>)

Represents a JSON object

Methods

impl Value

fn find<'a>(&'a self, key: &str) -> Option<&'a Value>

If the Value is an Object, returns the value associated with the provided key. Otherwise, returns None.

fn find_path<'a>(&'a self, keys: &[&str]) -> Option<&'a Value>

Attempts to get a nested Value Object for each key in keys. If any key is found not to exist, find_path will return None. Otherwise, it will return the Value associated with the final key.

fn lookup<'a>(&'a self, path: &str) -> Option<&'a Value>

Looks up a value by path.

This is a convenience method that splits the path by '.' and then feeds the sequence of keys into the find_path method.

let obj: Value = json::from_str(r#"{"x": {"a": 1}}"#).unwrap();

assert!(obj.lookup("x.a").unwrap() == &Value::U64(1));

fn search<'a>(&'a self, key: &str) -> Option<&'a Value>

If the Value is an Object, performs a depth-first search until a value associated with the provided key is found. If no value is found or the Value is not an Object, returns None.

fn is_object<'a>(&'a self) -> bool

Returns true if the Value is an Object. Returns false otherwise.

fn as_object<'a>(&'a self) -> Option<&'a BTreeMap<String, Value>>

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

fn as_object_mut<'a>(&'a mut self) -> Option<&'a mut BTreeMap<String, Value>>

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

fn is_array<'a>(&'a self) -> bool

Returns true if the Value is an Array. Returns false otherwise.

fn as_array<'a>(&'a self) -> Option<&'a Vec<Value>>

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

fn as_array_mut<'a>(&'a mut self) -> Option<&'a mut Vec<Value>>

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

fn is_string<'a>(&'a self) -> bool

Returns true if the Value is a String. Returns false otherwise.

fn as_string<'a>(&'a self) -> Option<&'a str>

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

fn is_number(&self) -> bool

Returns true if the Value is a Number. Returns false otherwise.

fn is_i64(&self) -> bool

Returns true if the Value is a i64. Returns false otherwise.

fn is_u64(&self) -> bool

Returns true if the Value is a u64. Returns false otherwise.

fn is_f64(&self) -> bool

Returns true if the Value is a f64. Returns false otherwise.

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

If the Value is a number, return or cast it to a i64. Returns None otherwise.

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

If the Value is a number, return or cast it to a u64. Returns None otherwise.

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

If the Value is a number, return or cast it to a f64. Returns None otherwise.

fn is_boolean(&self) -> bool

Returns true if the Value is a Boolean. Returns false otherwise.

fn as_boolean(&self) -> Option<bool>

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

fn is_null(&self) -> bool

Returns true if the Value is a Null. Returns false otherwise.

fn as_null(&self) -> Option<()>

If the Value is a Null, returns (). Returns None otherwise.

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for Value

fn eq(&self, __arg_0: &Value) -> bool

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

fn ne(&self, __arg_0: &Value) -> bool

This method tests for !=.

impl Serialize for Value

fn serialize<S>(&self, serializer: &mut S) -> Result<(), S::Error> where
    S: Serializer, 

Serializes this value into this serializer.

impl Deserialize for Value

fn deserialize<D>(deserializer: &mut D) -> Result<Value, D::Error> where
    D: Deserializer, 

Deserialize this value given this Deserializer.

impl Debug for Value

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

Serializes a json value into a string