Struct SerializeRef 

pub struct SerializeRef<'a> { /* private fields */ }

A reference to a value that is serialized.

This is the type erased form of a Serialize value (and an adapter if it’s serialized with one). The serializers of the data formats receive the values as references, for instance from the SerializeDriver. The methods of the reference invoke the ones of Serialize.

use deser::adapters::DisplayFromStr;
use deser::ser::SerializeRef;

let value = 42u32;
assert!(!SerializeRef::new(&value).is_optional());

// serializes as string
let value = SerializeRef::serialize_as::<DisplayFromStr, _>(&value);

Deserialization has no equivalent: values are type erased by creating their Sink (see Deserialize::deserialize_into), which is already in the middle of deserializing them.

Implementations

impl<'a> SerializeRef<'a>

pub fn new<T: Serialize>(value: &'a T) -> SerializeRef<'a>

Creates a reference to a value.

pub fn serialize_as<A: Serialize<T>, T: Sync>(value: &'a T) -> SerializeRef<'a>

Creates a reference to a value that is serialized with an adapter.

See adapters.

pub fn serialize(self, state: &mut State) -> Result<Emit<'a>, Error>

Serializes the value (see Serialize::serialize).

pub fn finish(self, state: &mut State) -> Result<(), Error>

Invoked after the serialization finished (see Serialize::finish).

pub fn is_optional(self) -> bool

Checks if the value is optional (see Serialize::is_optional).

pub fn container_shape(self) -> ContainerShape

Returns the shape of the value (see Serialize::container_shape).

pub fn describe(self, d: &mut dyn Describe)

Describes the Rust shape of the value (see Serialize::describe).

Trait Implementations

impl<'a> Clone for SerializeRef<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SerializeRef<'a>

impl Debug for SerializeRef<'_>

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

Formats the value using the given formatter.

impl<'a, T: Serialize> From<&'a T> for SerializeRef<'a>

fn from(value: &'a T) -> SerializeRef<'a>

Converts to this type from the input type.

impl<'a> From<SerializeRef<'a>> for SerializeHandle<'a>

fn from(value: SerializeRef<'a>) -> SerializeHandle<'a>

Converts to this type from the input type.

impl Serialize for SerializeRef<'_>

fn serialize<'b>(value: &'b Self, state: &mut State) -> Result<Emit<'b>, Error>

Serializes the value.

fn finish(value: &Self, state: &mut State) -> Result<(), Error>

Invoked after the serialization finished.

fn is_optional(value: &Self) -> bool

Checks if the value represents an optional value.

fn container_shape(value: &Self) -> ContainerShape

Returns the shape of the value if it’s a map or sequence.

fn describe(value: &Self, d: &mut dyn Describe)

Describes the Rust shape of the value.