Struct OccupiedEntry

pub struct OccupiedEntry<'a> { /* private fields */ }

A view into a single occupied location in a Object.

Implementations

impl<'a> OccupiedEntry<'a>

pub fn get(&self) -> &Value

Gets a reference to the value in the entry.

Examples

use sonic_rs::{object, value::object::Entry, Value};

let mut obj = object! {"a": 1, "b": true, "c": null};

if let Entry::Occupied(entry) = obj.entry(&"a") {
    assert_eq!(entry.get(), 1);
}

if let Entry::Occupied(entry) = obj.entry(&"b") {
    assert_eq!(entry.get(), true);
}

pub fn get_mut(&mut self) -> &mut Value

Gets a mutable reference to the value in the entry.

Examples

use sonic_rs::{object, value::object::Entry, Value};

let mut obj = object! {"a": 1, "b": true, "c": null};
obj.insert(&"a", Value::from("hello"));

if let Entry::Occupied(mut entry) = obj.entry(&"a") {
    assert_eq!(entry.get_mut(), &Value::from("hello"));
}

if let Entry::Occupied(mut entry) = obj.entry(&"b") {
    assert_eq!(entry.get_mut(), &true);
}

pub fn into_mut(self) -> &'a mut Value

Converts the entry into a mutable reference to its value.

Examples

use sonic_rs::{object, value::object::Entry, Value};

let mut obj = object! {"a": 1, "b": true, "c": null};
obj.insert(&"a", Value::from("hello"));

if let Entry::Occupied(mut entry) = obj.entry(&"a") {
    let vref = entry.into_mut();
    assert_eq!(vref, &mut Value::from("hello"));
    *vref = Value::from("world");
}

assert_eq!(obj["a"], "world");

pub fn insert<T: Into<Value>>(&mut self, val: T) -> Value

Sets the value of the entry, and returns the entry’s old value.

Examples

use sonic_rs::{object, value::object::Entry};

let mut obj = object! {"a": 1, "b": true, "c": null};

if let Entry::Occupied(mut entry) = obj.entry(&"a") {
    assert_eq!(entry.insert("hello"), 1);
}
if let Entry::Occupied(mut entry) = obj.entry(&"a") {
    assert_eq!(entry.insert("world"), "hello");
}

pub fn remove(self) -> Value

Takes the value out of the entry, and returns it.

Examples

use sonic_rs::{object, value::object::Entry, Value};

let mut obj = object! {"a": 1, "b": true, "c": null};

if let Entry::Occupied(mut entry) = obj.entry(&"a") {
    assert_eq!(entry.remove(), 1);
}

if let Entry::Occupied(mut entry) = obj.entry(&"b") {
    assert_eq!(entry.remove(), true);
}

if let Entry::Occupied(mut entry) = obj.entry(&"c") {
    assert_eq!(entry.remove(), Value::default());
}
assert!(obj.is_empty());