Struct CompatibilityValueV2 

pub struct CompatibilityValueV2 { /* private fields */ }

One exact V2 compatibility scalar.

Ordinary values retain the released CanonicalValue wire. V1-only strings and non-canonical temporal, duration, or decimal spellings use deterministic bounded UTF-8 chunks so no individual JSON string exceeds the canonical codec ceiling.

Implementations

impl CompatibilityValueV2

pub const fn canonical(value: CanonicalValue) -> Self

Wrap one ordinary canonical scalar without changing its wire shape.

pub fn released_string(value: impl Into<String>) -> Result<Self, Diagnostic>

Preserve one released string above the canonical per-string ceiling.

pub fn released_datetime(value: impl Into<String>) -> Result<Self, Diagnostic>

Preserve one released timezone-free datetime spelling exactly.

pub fn released_datetime_tz( value: impl Into<String>, ) -> Result<Self, Diagnostic>

Preserve one released timezone-aware datetime spelling exactly.

pub fn released_duration(value: impl Into<String>) -> Result<Self, Diagnostic>

Preserve one released duration spelling exactly.

pub fn released_decimal(value: impl Into<String>) -> Result<Self, Diagnostic>

Preserve one released non-canonical decimal spelling exactly.

pub const fn value_type(&self) -> ValueTypeTag

Return the scalar domain claimed by this literal.

pub const fn canonical_value(&self) -> Option<&CanonicalValue>

Return the ordinary canonical value, when this is not a V1-only spelling.

pub const fn released_kind(&self) -> Option<ReleasedValueKindV2>

Return the released-only lexical domain, when present.

pub fn released_chunks(&self) -> Option<&[String]>

Return canonical bounded chunks for a released-only spelling.

pub fn released_text(&self) -> Option<String>

Reconstruct the exact released spelling.

pub fn semantic_cmp_same_domain(&self, other: &Self) -> Option<Ordering>

Compare two same-domain values with the released V1 result semantics.

Representation Ord remains the deterministic wire identity order. This method is for compatibility ordering and duplicate detection.

Trait Implementations

impl Clone for CompatibilityValueV2

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompatibilityValueV2

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompatibilityValueV2

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CompatibilityValueV2

impl From<CanonicalValue> for CompatibilityValueV2

fn from(value: CanonicalValue) -> Self

Converts to this type from the input type.

impl Hash for CompatibilityValueV2

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 Ord for CompatibilityValueV2

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for CompatibilityValueV2

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for CompatibilityValueV2

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for CompatibilityValueV2

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CompatibilityValueV2