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 referenced JSON tree using the safe recursive formatting bridge.

Formatting may allocate an explicit work stack for nested values.

Parameters

• formatter - Formatter that receives the JSON tree’s debug representation.

Returns

Ok(()) when formatting succeeds, or the formatting error reported by the formatter.

impl Eq for JsonValueRef<'_>

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

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

Compares the referenced JSON trees without requiring matching borrow lifetimes.

Equality uses an explicit work stack, which may allocate for nested values.

Parameters

• other - View of the JSON tree to compare with this one.

Returns

true when both referenced trees are equal; otherwise, false.

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,

Serializes the referenced JSON tree through the stack-growing Serde bridge.

The bridge supports library-side recursive calls, while the serializer may still impose its own recursion limits.

Type Parameters

• S - Serializer that receives the JSON tree’s serialized representation.

Parameters

• serializer - Serializer used to encode the borrowed JSON tree.

Returns

The value produced by the serializer after encoding succeeds.

Errors

Returns the serializer’s error if encoding the tree fails.