Enum dbus::MessageItem

pub enum MessageItem {
    Array(Vec<MessageItem>, TypeSig<'static>),
    Struct(Vec<MessageItem>),
    Variant(Box<MessageItem>),
    DictEntry(Box<MessageItem>, Box<MessageItem>),
    ObjectPath(Path<'static>),
    Str(String),
    Bool(bool),
    Byte(u8),
    Int16(i16),
    Int32(i32),
    Int64(i64),
    UInt16(u16),
    UInt32(u32),
    UInt64(u64),
    Double(f64),
    UnixFd(OwnedFd),
}

MessageItem - used as parameters and return values from method calls, or as data added to a signal.

Variants

Array(Vec<MessageItem>, TypeSig<'static>)

A D-Bus array requires all elements to be of the same type. All elements must match the TypeSig.

Struct(Vec<MessageItem>)

A D-Bus struct allows for values of different types.

Variant(Box<MessageItem>)

A D-Bus variant is a wrapper around another MessageItem, which can be of any type.

DictEntry(Box<MessageItem>, Box<MessageItem>)

A D-Bus dictionary is an Array of DictEntry items.

ObjectPath(Path<'static>)

A D-Bus objectpath requires its content to be a valid objectpath, so this cannot be any string.

Str(String)

A D-Bus String is zero terminated, so no \0 s in the String, please. (D-Bus strings are also - like Rust strings - required to be valid UTF-8.)

Bool(bool)

A D-Bus boolean type.

Byte(u8)

A D-Bus unsigned 8 bit type.

Int16(i16)

A D-Bus signed 16 bit type.

Int32(i32)

A D-Bus signed 32 bit type.

Int64(i64)

A D-Bus signed 64 bit type.

UInt16(u16)

A D-Bus unsigned 16 bit type.

UInt32(u32)

A D-Bus unsigned 32 bit type.

UInt64(u64)

A D-Bus unsigned 64 bit type.

Double(f64)

A D-Bus IEEE-754 double-precision floating point type.

UnixFd(OwnedFd)

D-Bus allows for sending file descriptors, which can be used to set up SHM, unix pipes, or other communication channels.

Methods

impl MessageItem

fn type_sig(&self) -> TypeSig<'static>

Get the D-Bus ASCII type-code for this MessageItem.

fn array_type(&self) -> i32

Get the integer value for this MessageItem's type-code.

fn from_dict<E, I: Iterator<Item=Result<(String, MessageItem), E>>>(i: I) -> Result<MessageItem, E>

Creates a (String, Variant) dictionary from an iterator with Result passthrough (an Err will abort and return that Err)

fn new_array(v: Vec<MessageItem>) -> Result<MessageItem, ArrayError>

Creates an MessageItem::Array from a list of MessageItems.

Note: This requires v to be non-empty. See also MessageItem::from(&[T]), which can handle empty arrays as well.

fn inner<'a, T: FromMessageItem<'a>>(&'a self) -> Result<T, ()>

Conveniently get the inner value of a MessageItem

Example

use dbus::MessageItem;
let m: MessageItem = 5i64.into();
let s: i64 = m.inner().unwrap();
assert_eq!(s, 5i64);

Trait Implementations

impl Debug for MessageItem

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl PartialEq for MessageItem

fn eq(&self, __arg_0: &MessageItem) -> bool

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

fn ne(&self, __arg_0: &MessageItem) -> bool

This method tests for !=.

impl PartialOrd for MessageItem

fn partial_cmp(&self, __arg_0: &MessageItem) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, __arg_0: &MessageItem) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, __arg_0: &MessageItem) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, __arg_0: &MessageItem) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, __arg_0: &MessageItem) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Clone for MessageItem

fn clone(&self) -> MessageItem

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<u8> for MessageItem

fn from(i: u8) -> MessageItem

Performs the conversion.

impl From<u64> for MessageItem

fn from(i: u64) -> MessageItem

Performs the conversion.

impl From<u32> for MessageItem

fn from(i: u32) -> MessageItem

Performs the conversion.

impl From<u16> for MessageItem

fn from(i: u16) -> MessageItem

Performs the conversion.

impl From<i16> for MessageItem

fn from(i: i16) -> MessageItem

Performs the conversion.

impl From<i32> for MessageItem

fn from(i: i32) -> MessageItem

Performs the conversion.

impl From<i64> for MessageItem

fn from(i: i64) -> MessageItem

Performs the conversion.

impl From<f64> for MessageItem

fn from(i: f64) -> MessageItem

Performs the conversion.

impl From<bool> for MessageItem

fn from(i: bool) -> MessageItem

Performs the conversion.

impl<'a, T> From<&'a [T]> for MessageItem where T: Into<MessageItem> + Clone + Default

Create a MessageItem::Array.

fn from(i: &'a [T]) -> MessageItem

Performs the conversion.

impl<'a> From<&'a str> for MessageItem

fn from(i: &str) -> MessageItem

Performs the conversion.

impl From<String> for MessageItem

fn from(i: String) -> MessageItem

Performs the conversion.

impl From<Path<'static>> for MessageItem

fn from(i: Path<'static>) -> MessageItem

Performs the conversion.

impl From<OwnedFd> for MessageItem

fn from(i: OwnedFd) -> MessageItem

Performs the conversion.

impl From<Box<MessageItem>> for MessageItem

Create a MessageItem::Variant

fn from(i: Box<MessageItem>) -> MessageItem

Performs the conversion.

impl From<(MessageItem, MessageItem)> for MessageItem

Create a MessageItem::DictEntry

fn from(i: (MessageItem, MessageItem)) -> MessageItem

Performs the conversion.

impl<'a> FromMessageItem<'a> for &'a MessageItem

fn from(i: &'a MessageItem) -> Result<&'a MessageItem, ()>

Allows converting from a MessageItem into the type it contains.

impl PropertyROHandler for MessageItem

fn get(&self) -> PropertyGetResult

Get a property's value.

impl Append for MessageItem

fn append(self, i: &mut IterAppend)

Performs the append operation.

impl<'a> Get<'a> for MessageItem

fn get(i: &mut Iter<'a>) -> Option<Self>

Performs the get operation.