Struct zvariant::serialized::Context

pub struct Context { /* private fields */ }

The encoding context to use with the serialization and deserialization API.

The encoding is dependent on the position of the encoding in the entire message and hence the need to specify the byte position of the data being serialized or deserialized. Simply pass 0 if serializing or deserializing to or from the beginning of message, or the preceding bytes end on an 8-byte boundary.

Examples

use zvariant::Endian;
use zvariant::serialized::Context;
use zvariant::to_bytes;

let str_vec = vec!["Hello", "World"];
let ctxt = Context::new_dbus(Endian::Little, 0);
let encoded = to_bytes(ctxt, &str_vec).unwrap();

// Let's decode the 2nd element of the array only
let slice = encoded.slice(14..);
let decoded: &str = slice.deserialize().unwrap().0;
assert_eq!(decoded, "World");

Implementations

impl Context

pub fn new(format: Format, endian: Endian, position: usize) -> Self

Create a new encoding context.

pub fn new_dbus(endian: Endian, position: usize) -> Self

Convenient wrapper for new to create a context for D-Bus format.

pub fn new_gvariant(endian: Endian, position: usize) -> Self

Convenient wrapper for new to create a context for GVariant format.

pub fn format(self) -> Format

The Format of this context.

pub fn endian(self) -> Endian

The Endian of this context.

pub fn position(self) -> usize

The byte position of the value to be encoded or decoded, in the entire message.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.

impl PartialEq for Context

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Context

impl Eq for Context

impl StructuralPartialEq for Context