Struct ValueWireRefV1 

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

Borrowed standalone V1 envelope for serialization without cloning.

Type Parameters

• 'a - Lifetime of the runtime payload borrowed for serialization.

Examples

use qubit_value::{Value, ValueWireRefV1};

let value = Value::from(42_i32);
let _wire = ValueWireRefV1::from_value(&value).unwrap();

Implementations

impl<'a> ValueWireRefV1<'a>

pub fn from_value(value: &'a Value) -> Result<Self, ValueWireEncodeError>

Borrows a scalar after validating V1’s finite-float invariant.

Parameters

• value - Scalar runtime value to validate and borrow.

Returns

A standalone borrowed V1 envelope containing the scalar.

Errors

Returns ValueWireEncodeError when the scalar violates V1 numeric representation constraints.

pub fn from_values( values: &'a MultiValues, ) -> Result<Self, ValueWireEncodeError>

Borrows a collection after validating V1’s finite-float invariant.

Parameters

• values - Homogeneous runtime collection to validate and borrow.

Returns

A standalone borrowed V1 envelope containing the collection.

Errors

Returns ValueWireEncodeError when an element violates V1 numeric representation constraints.

pub fn from_container( value: &'a ValueContainer, ) -> Result<Self, ValueWireEncodeError>

Borrows an explicit shape after validating V1’s finite-float invariant.

Parameters

• value - Explicit scalar-or-collection value to validate and borrow.

Returns

A standalone borrowed V1 envelope preserving the original shape.

Errors

Returns ValueWireEncodeError when any contained value violates V1 numeric representation constraints.

pub const fn new(value: ValueWirePayloadRefV1<'a>) -> Self

Wraps an already validated borrowed payload.

Parameters

• value - Validated borrowed payload to place in the V1 envelope.

Returns

A standalone borrowed V1 envelope.

pub fn to_json_vec(&self) -> Result<Vec<u8>, ValueWireEncodeError>

Encodes the borrowed V1 envelope into a compact JSON vector.

Returns

Compact UTF-8 JSON bytes for the complete V1 envelope.

Errors

Returns ValueWireEncodeError for resource or serialization failures.

pub fn to_json_vec_with_limits( &self, limits: JsonEncodeLimits, ) -> Result<Vec<u8>, ValueWireEncodeError>

Encodes the borrowed V1 envelope with explicit JSON resource limits.

Parameters

• limits - Resource limits enforced during JSON encoding.

Returns

Compact UTF-8 JSON bytes for the complete V1 envelope.

Errors

Returns ValueWireEncodeError when encoding exceeds limits or Serde rejects the envelope.

pub fn to_json_writer<W>(&self, writer: W) -> Result<(), ValueWireEncodeError>

where W: Write,

Encodes the borrowed V1 envelope to a writer with default limits.

Type Parameters

• W - Destination writer type.

Parameters

• writer - Destination receiving the complete V1 JSON envelope.

Returns

Ok(()) after the complete envelope is written.

Errors

Returns ValueWireEncodeError for resource, serialization, or writer failures.

pub fn to_json_writer_with_limits<W>( &self, writer: W, limits: JsonEncodeLimits, ) -> Result<(), ValueWireEncodeError>

where W: Write,

Encodes the borrowed V1 envelope to a writer with explicit limits.

Type Parameters

• W - Destination writer type.

Parameters

• writer - Destination receiving the complete V1 JSON envelope.
• limits - Resource limits enforced during JSON encoding.

Returns

Ok(()) after the complete envelope is written.

Errors

Returns ValueWireEncodeError when encoding exceeds limits, Serde rejects the envelope, or writer rejects output.

Trait Implementations

impl Serialize for ValueWireRefV1<'_>

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

where S: Serializer,

Serializes the borrowed runtime shape through the V1 envelope.

impl<'a> TryFrom<&'a MultiValues> for ValueWireRefV1<'a>

fn try_from(values: &'a MultiValues) -> Result<Self, Self::Error>

Borrows and validates a collection.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.

impl<'a> TryFrom<&'a Value> for ValueWireRefV1<'a>

fn try_from(value: &'a Value) -> Result<Self, Self::Error>

Borrows and validates a scalar.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.

impl<'a> TryFrom<&'a ValueContainer> for ValueWireRefV1<'a>

fn try_from(value: &'a ValueContainer) -> Result<Self, Self::Error>

Borrows and validates an explicit shape.

type Error = ValueWireEncodeError

The type returned in the event of a conversion error.