Struct Update 

pub struct Update { /* private fields */ }

An ordered list of field operations.

use tarant::Update;

let ops = Update::new()
    .set(2, "ann")        // field 2 = "ann"
    .add(3, 1)            // field 3 += 1
    .delete(4, 1);        // remove one field starting at 4
assert_eq!(ops.len(), 3);

Operations are encoded as they are added; an argument that cannot be serialised is reported by the request that carries the update.

Implementations

impl Update

pub fn new() -> Self

No operations yet.

pub fn set(self, field: impl Into<FieldRef>, value: impl Serialize) -> Self

=: assign value to field, extending the tuple if it is the next field.

pub fn add(self, field: impl Into<FieldRef>, delta: impl Serialize) -> Self

+: add delta to a numeric field.

pub fn sub(self, field: impl Into<FieldRef>, delta: impl Serialize) -> Self

-: subtract delta from a numeric field.

pub fn bit_and(self, field: impl Into<FieldRef>, mask: u64) -> Self

&: bitwise AND with mask on an unsigned field.

pub fn bit_or(self, field: impl Into<FieldRef>, mask: u64) -> Self

|: bitwise OR with mask on an unsigned field.

pub fn bit_xor(self, field: impl Into<FieldRef>, mask: u64) -> Self

^: bitwise XOR with mask on an unsigned field.

pub fn insert(self, field: impl Into<FieldRef>, value: impl Serialize) -> Self

!: insert value before field, shifting the rest right.

pub fn delete(self, field: impl Into<FieldRef>, count: u32) -> Self

#: delete count fields starting at field.

pub fn splice( self, field: impl Into<FieldRef>, offset: i32, len: u32, replacement: &str, ) -> Self

:: replace len bytes at byte offset (1-based) of a string field with replacement.

pub fn len(&self) -> usize

Number of operations.

pub fn is_empty(&self) -> bool

Whether no operations were added.

Trait Implementations

impl Clone for Update

fn clone(&self) -> Update

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Update

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

Formats the value using the given formatter.

impl Default for Update

fn default() -> Update

Returns the “default value” for a type.