Struct NamedValue 

pub struct NamedValue { /* private fields */ }

Named single value

Associates a human-readable name with a single Value, facilitating identification, retrieval, and display in configurations, parameter passing, and complex data structures.

Features

• Provides stable name identification for values
• Exposes the inner Value through explicit accessors
• Supports serde serialization and deserialization

Use Cases

• Configuration item encapsulation (e.g., "port", "timeout", etc.)
• Named output of key values in logs/monitoring
• Quick location by name in collections

Examples

use qubit_value::{NamedValue, Value};

let named = NamedValue::new("flag", Value::Bool(true));
assert!(named.value().get_bool().unwrap());

The wrapper intentionally does not forward Value methods implicitly:

use qubit_value::{NamedValue, Value};

let named = NamedValue::new("flag", Value::Bool(true));
let _ = named.get_bool();

Implementations

impl NamedValue

pub fn new(name: impl Into<String>, value: Value) -> Self

Create a new named value

Creates a binding instance between a name and a value.

Parameters

• name - Name of the value
• value - Content of the value

Returns

Returns a newly created NamedValue instance

Examples

use qubit_value::{NamedValue, Value};

let named = NamedValue::new("timeout", Value::Int32(30));
assert_eq!(named.name(), "timeout");

pub fn decode_json_slice(input: &[u8]) -> Result<Self, ValueWireDecodeError>

Decodes a complete named scalar JSON document with default limits.

Parameters

• input - Complete UTF-8 JSON document to decode.

Returns

The decoded named scalar.

Errors

Returns a JSON, wire-contract, or resource-limit error.

pub fn decode_json_slice_with_limits( input: &[u8], limits: WireLimits, ) -> Result<Self, ValueWireDecodeError>

Decodes a complete named scalar JSON document with explicit limits.

The wrapper name and nested scalar share one accounting session.

Parameters

• input - Complete UTF-8 JSON document to decode.
• limits - Input and decoded-resource limits.

Returns

The decoded named scalar.

Errors

Returns a JSON, wire-contract, or resource-limit error.

pub fn name(&self) -> &str

Get a reference to the name

Returns a read-only name slice bound to this value.

Returns

Returns a string slice &str of the name

Examples

use qubit_value::{NamedValue, Value};

let named = NamedValue::new("host", Value::String("localhost".to_string()));
assert_eq!(named.name(), "host");

pub fn set_name(&mut self, name: impl Into<String>)

Set a new name

Updates the name bound to the current instance.

Parameters

• name - The new name

Examples

use qubit_value::{NamedValue, Value};

let mut named = NamedValue::new("old_name", Value::Bool(true));
named.set_name("new_name");
assert_eq!(named.name(), "new_name");

pub fn value(&self) -> &Value

Borrows the contained value.

Returns

A shared reference to the contained Value.

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

Mutably borrows the contained value.

Returns

An exclusive reference to the contained Value.

pub fn set_value(&mut self, value: Value)

Replaces the contained value.

Parameters

• value - New value to store under the existing name.

pub fn into_parts(self) -> (String, Value)

Consumes this wrapper and returns its owned name and value.

Returns

The (name, value) pair without cloning either component.

Trait Implementations

impl Clone for NamedValue

fn clone(&self) -> NamedValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NamedValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NamedValue

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserializes a named scalar value from the V1 wire contract.

impl Eq for NamedValue

impl From<NamedValue> for NamedMultiValues

fn from(named: NamedValue) -> Self

Construct NamedMultiValues from NamedValue

Reuses the name and promotes the single value to a MultiValues containing only one element.

impl Hash for NamedValue

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for NamedValue

fn eq(&self, other: &NamedValue) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Redact for NamedValue

fn redacted(&self) -> Redacted<'_, Self>

where Self: Sized,

Creates a borrowed view using a snapshot of the current default policy.

fn redacted_with(&self, policy: &RedactionPolicy) -> Redacted<'_, Self>

where Self: Sized,

Creates a borrowed view using a snapshot of policy.

impl Serialize for NamedValue

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

where S: Serializer,

Serializes the name and its explicitly versioned scalar value.

impl StructuralPartialEq for NamedValue