Struct Change 

#[non_exhaustive]
pub struct Change {
    pub path: Arc<str>,
    pub old_value: OwnedDataValue,
    pub new_value: OwnedDataValue,
    pub removed: bool,
    pub replaced: bool,
    /* private fields */
}

One write or removal, written as v3 wrote one.

A path that was absent before the write records old_value as null.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

path: Arc<str>

The dotted path written.

old_value: OwnedDataValue

What the path held before; null when it was absent.

new_value: OwnedDataValue

The value written; null for a removal (read removed to tell a removal from a write of null).

removed: bool

The key at path was removed rather than written. Absent when false, so a write’s JSON is v3’s.

replaced: bool

The write replaced the root at path instead of merging into it: a host function’s write at a root replaces it, and map’s root mapping, which records only the keys it wrote, merges. A trace’s changes carry it, so a replay knows which; an audit entry’s are always false, so the audit trail’s JSON is v3’s. Absent when false.

Implementations

impl Change

pub fn write( path: impl Into<Arc<str>>, old_value: OwnedDataValue, new_value: OwnedDataValue, ) -> Self

A write of new_value over old_value at path.

pub fn removal(path: impl Into<Arc<str>>, old_value: OwnedDataValue) -> Self

A removal of the key at path, which held old_value.

Trait Implementations

impl Clone for Change

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 Change

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

The wire fields, as a derive would show them; every field named, as in eq.

impl<'de> Deserialize<'de> for Change

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Change

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

The wire fields; not whether the change is the trace’s alone. The destructuring names every field, so a field added later does not compile until it is compared or deliberately left out.

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

Inequality operator !=.

impl Serialize for Change

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.