Struct JsonValueRef 

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

An immutable, borrowed view of a JSON value.

Constructing a view copies only a reference. Equality and debug formatting use explicit work stacks, which may allocate. Serialization uses the same stacker-backed recursive Serde bridge as SafeJsonValue. The bridge can grow the stack for library-side recursive calls, but the selected serializer may still impose its own recursion limits; it does not promise an exact memory bound or support unlimited depth. The view does not protect the borrowed tree’s destruction when its owner is dropped.

Examples

use qubit_json::value::{JsonValueRef, SafeJsonValue};

let owner = SafeJsonValue::new(serde_json::json!({"items": [1, 2]}));
let view = JsonValueRef::new(owner.as_value());
assert_eq!(
    serde_json::to_vec(&view).unwrap(),
    serde_json::to_vec(&owner).unwrap()
);

The view cannot outlive its borrowed owner:

use qubit_json::value::{JsonValueRef, SafeJsonValue};
let view = {
    let owner = SafeJsonValue::new(serde_json::json!([1]));
    JsonValueRef::new(owner.as_value())
};
println!("{view:?}");

Implementations

impl<'a> JsonValueRef<'a>

pub const fn new(value: &'a Value) -> Self

Borrows a JSON tree without copying, traversing, or admitting it to a budget.

Parameters

• value - Tree that must remain alive for the lifetime of this view.

Returns

A read-only view tied to the supplied borrow. Construction does not allocate.

pub const fn as_value(self) -> &'a Value

Returns the borrowed JSON value, preserving its original owner lifetime.

Consuming this view does not extend the lifetime of the underlying tree.

Returns

The JSON tree borrowed by this view.

Trait Implementations

impl<'a> Clone for JsonValueRef<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for JsonValueRef<'a>

impl Debug for JsonValueRef<'_>

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

Formats the value using the given formatter.

impl Eq for JsonValueRef<'_>

impl<'a, 'b> PartialEq<JsonValueRef<'b>> for JsonValueRef<'a>

fn eq(&self, other: &JsonValueRef<'b>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for JsonValueRef<'_>

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

where S: Serializer,

Serialize this value into the given Serde serializer.