Enum rustless::json::JsonValue
[−]
[src]
pub enum JsonValue { 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 null value
Bool(bool)
Represents a JSON Boolean
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
[src]
fn find(&'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 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 self, path: &str) -> Option<&'a Value>
Deprecated: Use Value.pointer()
and pointer syntax instead.
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 pointer(&'a self, pointer: &str) -> Option<&'a Value>
Looks up a value by a JSON Pointer.
JSON Pointer defines a string syntax for identifying a specific value within a JavaScript Object Notation (JSON) document.
A Pointer is a Unicode string with the reference tokens separated by /
.
Inside tokens /
is replaced by ~1
and ~
is replaced by ~0
. The
addressed value is returned and if there is no such value None
is
returned.
For more information read RFC6901.
fn pointer_mut(&'a mut self, pointer: &str) -> Option<&'a mut Value>
Looks up a value by a JSON Pointer and returns a mutable reference to that value.
JSON Pointer defines a string syntax for identifying a specific value within a JavaScript Object Notation (JSON) document.
A Pointer is a Unicode string with the reference tokens separated by /
.
Inside tokens /
is replaced by ~1
and ~
is replaced by ~0
. The
addressed value is returned and if there is no such value None
is
returned.
For more information read RFC6901.
Example of Use
extern crate serde_json; use serde_json::Value; use std::mem; fn main() { let s = r#"{"x": 1.0, "y": 2.0}"#; let mut value: Value = serde_json::from_str(s).unwrap(); // Check value using read-only pointer assert_eq!(value.pointer("/x"), Some(&Value::F64(1.0))); // Change value with direct assignment *value.pointer_mut("/x").unwrap() = Value::F64(1.5); // Check that new value was written assert_eq!(value.pointer("/x"), Some(&Value::F64(1.5))); // "Steal" ownership of a value. Can replace with any valid Value. let old_x = value.pointer_mut("/x").map(|x| mem::replace(x, Value::Null)).unwrap(); assert_eq!(old_x, Value::F64(1.5)); assert_eq!(value.pointer("/x").unwrap(), &Value::Null); }
fn search(&'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(&self) -> bool
Returns true if the Value
is an Object. Returns false otherwise.
fn as_object(&self) -> Option<&BTreeMap<String, Value>>
If the Value
is an Object, returns the associated Map.
Returns None otherwise.
fn as_object_mut(&mut self) -> Option<&mut BTreeMap<String, Value>>
If the Value
is an Object, returns the associated mutable Map.
Returns None otherwise.
fn is_array(&self) -> bool
Returns true if the Value
is an Array. Returns false otherwise.
fn as_array(&self) -> Option<&Vec<Value>>
If the Value
is an Array, returns the associated vector.
Returns None otherwise.
fn as_array_mut(&mut self) -> Option<&mut Vec<Value>>
If the Value
is an Array, returns the associated mutable vector.
Returns None otherwise.
fn is_string(&self) -> bool
Returns true if the Value
is a String. Returns false otherwise.
fn as_str(&self) -> Option<&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_bool(&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 Display for Value
[src]
impl Serialize for Value
[src]
fn serialize<S>(
&self,
serializer: &mut S
) -> Result<(), <S as Serializer>::Error> where
S: Serializer,
&self,
serializer: &mut S
) -> Result<(), <S as Serializer>::Error> where
S: Serializer,
impl FromStr for Value
[src]
impl Deserialize for Value
[src]
fn deserialize<D>(
deserializer: &mut D
) -> Result<Value, <D as Deserializer>::Error> where
D: Deserializer,
deserializer: &mut D
) -> Result<Value, <D as Deserializer>::Error> where
D: Deserializer,
impl PartialEq<Value> for Value
[src]
impl Debug for Value
[src]
impl Clone for Value
[src]
fn clone(&self) -> Value
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more