Struct OwnedMessage

pub struct OwnedMessage(/* private fields */);

A message on a port.

The message has a static lifetime and is Send, so it is appropriate for storing and using across threads.

See Message for a version that can reference data with non-static lifetime.

Implementations

impl OwnedMessage

pub fn serialize(self) -> SerializedMessage

Serializes the message and returns it.

impl OwnedMessage

pub fn new<T: SerializeMessage + Send>(data: T) -> Self

Creates a new message wrapping data, which will be lazily serialized when needed.

pub fn serialized(s: SerializedMessage) -> Self

Creates a new message from already-serialized data in s.

pub fn parse<T>(self) -> Result<T, Error>

where T: 'static + DefaultEncoding, T::Encoding: for<'a> MessageDecode<'a, T, Resource>,

Parses the message into a value of type T.

If the message was constructed with new<T>, then the round trip serialization/deserialization is skipped.

pub fn try_unwrap<T: 'static>(self) -> Result<T, Self>

Tries to unwrap the message into a value of type T.

If the message was not created with OwnedMessage::new<T>, then this returns Err(self).

Trait Implementations

impl Debug for OwnedMessage

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

Formats the value using the given formatter.

impl Default for OwnedMessage

fn default() -> OwnedMessage

Returns the “default value” for a type.

impl DefaultEncoding for OwnedMessage

type Encoding = MessageEncoding<MessageEncoder>

The encoding to use for the serialization.

impl From<OwnedMessage> for Message<'_>

fn from(m: OwnedMessage) -> Self

Converts to this type from the input type.

impl MessageDecode<'_, OwnedMessage, Resource> for MessageEncoder

fn read_message( item: &mut InplaceOption<'_, OwnedMessage>, reader: MessageReader<'_, '_, Resource>, ) -> Result<()>

Reads a message into item.

impl MessageEncode<OwnedMessage, Resource> for MessageEncoder

fn write_message(item: OwnedMessage, writer: MessageWriter<'_, '_, Resource>)

Writes item as a message.

fn compute_message_size(item: &mut OwnedMessage, sizer: MessageSizer<'_>)

Computes the size of item as a message.