[][src]Enum serde_json::value::Value

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

Represents a JSON value

Variants

Represents a JSON null value

Represents a JSON Boolean

Represents a JSON signed integer

Represents a JSON unsigned integer

Represents a JSON floating point number

Represents a JSON string

Represents a JSON array

Represents a JSON object

Methods

impl Value
[src]

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

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.

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.

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

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

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.

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);
}

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Trait Implementations

impl Clone for Value
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl PartialEq<Value> for Value
[src]

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

This method tests for !=.

impl Display for Value
[src]

Serializes a json value into a string

impl Debug for Value
[src]

Serializes a json value into a string

impl FromStr for Value
[src]

The associated error which can be returned from parsing.

Parses a string s to return a value of this type. Read more

impl Serialize for Value
[src]

Serializes this value into this serializer.

impl Deserialize for Value
[src]

Deserialize this value given this Deserializer.

Auto Trait Implementations

impl Send for Value

impl Sync for Value

Blanket Implementations

impl<T> ToJson for T where
    T: Serialize + ?Sized
[src]

Converts the value of self to an instance of JSON

impl<T> From for T
[src]

Performs the conversion.

impl<T, U> Into for T where
    U: From<T>, 
[src]

Performs the conversion.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

Converts the given value to a String. Read more

impl<T> ToOwned for T where
    T: Clone
[src]

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

🔬 This is a nightly-only experimental API. (try_from)

Performs the conversion.

impl<T> Borrow for T where
    T: ?Sized
[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut for T where
    T: ?Sized
[src]

Mutably borrows from an owned value. Read more

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

🔬 This is a nightly-only experimental API. (try_from)

Performs the conversion.

impl<T> Any for T where
    T: 'static + ?Sized
[src]

🔬 This is a nightly-only experimental API. (get_type_id)

this method will likely be replaced by an associated static

Gets the TypeId of self. Read more