Struct Wire 

pub struct Wire<T>
where
    T: ?Sized,
{ /* private fields */ }

Wraps and transfers complex objects over FFI.

The backing storage uses a (ptr, size) representation that can safely cross FFI boundaries. See the module documentation for more details and examples.

Implementations

impl<T: TypeInfo + WireIO> Wire<T>

pub fn try_from(value: T) -> Result<Self, SerializationError>

Serialize value into a new owned Wire.

Errors

Returns SerializationError if value cannot be serialized into the buffer.

pub fn from(value: T) -> Self

Serialize value into a new owned Wire.

Panics

Panics at compile time if T::WIRE_SAFE is false.

pub fn try_unwire(&mut self) -> Result<T, SerializationError>

Deserialize the value from this Wire’s buffer.

Errors

Returns SerializationError if the buffer contents cannot be deserialized into T (e.g., truncated buffer, malformed data).

pub fn unwire(&mut self) -> T

Deserialize the value from this Wire’s buffer.

Panics

Panics at compile time if T::WIRE_SAFE is false.

Trait Implementations

impl<T: ?Sized> Clone for Wire<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: TypeInfo + WireIO> TypeInfo for Wire<T>

const WIRE_SAFE: bool = false

Whether this type can be used inside a Wire<T>.

const RAW_SAFE: bool = true

Whether this type can be passed directly over the FFI boundary.

const ASYNC_SAFE: bool = true

Whether this type can appear in an async service method.

const SERVICE_SAFE: bool = true

Whether this type can appear in a service method.

const SERVICE_CTOR_SAFE: bool = true

Whether this type is valid as a service constructor return type.

fn id() -> TypeId

The unique identifier for this type.

fn kind() -> TypeKind

The structural kind of this type.

fn ty() -> Type

The full type description.

fn register(inventory: &mut impl Inventory)

Registers this type and all its transitive dependencies with the inventory.

const OPTION_PTR_SAFE: bool = false

Whether std::Option<Self> uses a niche and is FFI-safe as a pointer (e.g., references, NonNull, function pointers).

impl<T: WireIO> WireIO for Wire<T>

fn write(&self, _: &mut impl Write) -> Result<(), SerializationError>

Serializes this value into the writer.

fn read(_: &mut impl Read) -> Result<Self, SerializationError>

Deserializes a value from the reader.

fn live_size(&self) -> usize

Returns the serialized size of this value in bytes.