Trait async_rustbus::rustbus_core::wire::marshal::traits::Signature[−][src]

pub trait Signature {
    pub fn signature() -> Type;
    pub fn alignment() -> usize;

    pub unsafe fn valid_slice(_bo: ByteOrder) -> bool { ... }
    pub fn sig_str(s_buf: &mut SignatureBuffer) { ... }
}

Required methods

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

Loading content...

Provided methods

`pub unsafe fn valid_slice(_bo: ByteOrder) -> bool`[src]

If this returns true, it indicates that for implementing type T, Rust’s [T] is identical to DBus’s array format and can be copied into a message after aligning the first element.

The default implementation is false but can be overridden for a performance gain if it is valid.

Safety

Calls to this function should always be safe. Implementors should respect this property. The reason this method is unsafe is to indicate to people implementing Signature that overriding it has the potential to induce unsound behavior if the following rules aren’t followed:

The type T implementing Signature must be Copy.
The size of T must be equivalent to it’s DBus alignment (see here).
Every possible bit-pattern must represent a valid instance of T. For example std::num::NonZeroU32 does not meet this requirement 0 is invalid.
The type should not contain an Fd receieved from the message. When implementing Unmarshal the type should only dependent the 'buf lifetime. It should never require the use of 'fds.

Notes

This method exists because of limitiation with Rust type system. Should #[feature(specialization)] ever become stablized this will hopefully be unnecessary.
This method should use the ByteOrder to check if it matches native order before returning true. ByteOrder::NATIVE can be used to detect the native order.

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

Appends the signature of the type to the SignatureBuffer.

By using SignatureBuffer, implementations of this method can avoid unnecessary allocations by only allocating if a signature is dynamic.

The default implementation of sig_str can be pretty slow. If type, that Signature is being implemented for, has a static (unchanging) signature then overriding this method can have a significant performance benefit when marshal/unmarshalling the type inside variants.

Loading content...

Implementations on Foreign Types

`impl<'_, E> Signature for &'_ [E] where E: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl<'_, E> Signature for Cow<'_, [E]> where E: Signature + Clone,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<E1, E2, E3> Signature for (E1, E2, E3) where E1: Signature, E2: Signature, E3: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for i64`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl<E> Signature for Vec<E, Global> where E: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<E1, E2, E3, E4, E5> Signature for (E1, E2, E3, E4, E5) where E1: Signature, E2: Signature, E3: Signature, E4: Signature, E5: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for i32`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl<E> Signature for (E,) where E: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<E> Signature for [E] where E: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for u16`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl Signature for i16`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl Signature for u8`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl Signature for bool`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl Signature for String`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl<'_> Signature for &'_ str`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl<'_, S> Signature for &'_ S where S: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<E1, E2> Signature for (E1, E2) where E1: Signature, E2: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for u32`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl Signature for u64`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub unsafe fn valid_slice(bo: ByteOrder) -> bool`[src]

`pub fn sig_str(sig: &mut SignatureBuffer)`[src]

`impl<'_> Signature for &'_ (dyn AsRawFd + '_)`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<K, V> Signature for HashMap<K, V, RandomState> where K: Signature, V: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<E1, E2, E3, E4> Signature for (E1, E2, E3, E4) where E1: Signature, E2: Signature, E3: Signature, E4: Signature,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

Loading content...

Implementors

`impl Signature for &async_rustbus::rustbus_core::path::ObjectPath`[src]

`fn signature() -> Type`[src]

`fn alignment() -> usize`[src]

`fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for DynamicHeader`[src]

`fn signature() -> Type`[src]

`fn alignment() -> usize`[src]

`impl Signature for ObjectPathBuf`[src]

`fn signature() -> Type`[src]

`fn alignment() -> usize`[src]

`fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl Signature for UnixFd`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<'_> Signature for SignatureWrapper<'_>`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`pub fn sig_str(s_buf: &mut SignatureBuffer)`[src]

`impl<'_, '_> Signature for Variant<'_, '_>`[src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<'a, E> Signature for OptimizedMarshal<'a, E> where E: Copy + Marshal,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

`impl<'fds, 'buf> Signature for HdrVar<'fds, 'buf>`[src]

`fn signature() -> Type`[src]

`fn alignment() -> usize`[src]

`impl<S> Signature for async_rustbus::rustbus_core::wire::marshal::traits::ObjectPath<S> where S: AsRef<str>,` [src]

`pub fn signature() -> Type`[src]

`pub fn alignment() -> usize`[src]

Loading content...