Struct NameOwnerChanged 

#[non_exhaustive]
pub struct NameOwnerChanged {
    pub name: String,
    pub old_owner: Option<String>,
    pub new_owner: Option<String>,
}

The org.freedesktop.DBus.NameOwnerChanged signal, which the bus emits when the ownership of a well known name changes.

Register interest with Connection::watch_name, then decode incoming signals with decode().

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The name whose ownership changed.

old_owner: Option<String>

The unique name of the previous owner, or None when the name was not owned before.

new_owner: Option<String>

The unique name of the new owner, or None when the name went away.

Implementations

impl NameOwnerChanged

pub const MEMBER: &'static str = "NameOwnerChanged"

The member name of this signal.

pub fn decode(message: &SignalMessage) -> Result<Option<Self>>

Decode a NameOwnerChanged signal.

Returns None when the message is some other signal, so this can be applied to everything which arrives without inspecting the message first. The empty owner strings the bus uses for “no owner” are decoded into None.

Examples

use tokio_dbus_runtime::{Connection, Incoming, NameOwnerChanged};

let mut c = Connection::session_bus().await?;
c.watch_name("org.kde.StatusNotifierWatcher").await?;

loop {
    if let Incoming::Signal(message) = c.next().await? {
        if let Some(changed) = NameOwnerChanged::decode(&message)? {
            if changed.new_owner.is_some() {
                // The watcher is back, register with it again.
            }
        }
    }
}

pub fn rule(name: &str) -> String

The match rule which selects this signal for name, as passed to Connection::add_match.

Examples

use tokio_dbus_runtime::NameOwnerChanged;

assert_eq!(
    NameOwnerChanged::rule("org.kde.StatusNotifierWatcher"),
    "type='signal',sender='org.freedesktop.DBus',interface='org.freedesktop.DBus',member='NameOwnerChanged',arg0='org.kde.StatusNotifierWatcher'",
);

Trait Implementations

impl Clone for NameOwnerChanged

fn clone(&self) -> NameOwnerChanged

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NameOwnerChanged

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

Formats the value using the given formatter.

impl Eq for NameOwnerChanged

impl PartialEq for NameOwnerChanged

fn eq(&self, other: &NameOwnerChanged) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NameOwnerChanged