Struct zbus::fdo::NameAcquired [−][src]
pub struct NameAcquired(_);
Expand description
A NameAcquired
signal.
Implementations
Retrieve the signal arguments.
Methods from Deref<Target = Message>
Take ownership of the associated file descriptors in the message.
When a message is received over a AF_UNIX socket, it may contain associated FDs. To prevent the message from closing those FDs on drop, call this method that returns all the received FDs with their ownership.
Note: the message will continue to reference the files, so you must keep them open for as long as the message itself.
The signature of the body.
Note: While zbus treats multiple arguments as a struct (to allow you to use the tuple syntax), D-Bus does not. Since this method gives you the signature expected on the wire by D-Bus, the trailing and leading STRUCT signature parenthesis will not be present in case of multiple arguments.
Deserialize the header.
Note: prefer using the direct access methods if possible; they are more efficient.
Deserialize the fields.
Note: prefer using the direct access methods if possible; they are more efficient.
The message type.
The object to send a call to, or the object a signal is emitted from.
The interface to invoke a method call on, or that a signal is emitted from.
The member, either the method name or signal name.
The serial number of the message this message is a reply to.
Deserialize the body (without checking signature matching).
Deserialize the body using the contained signature.
Example
let send_body = (7i32, (2i32, "foo"), vec!["bar"]);
let message = Message::method(None::<&str>, Some("zbus.test"), "/", Some("zbus.test"), "ping", &send_body)?;
let body : zvariant::Structure = message.body()?;
let fields = body.fields();
assert!(matches!(fields[0], zvariant::Value::I32(7)));
assert!(matches!(fields[1], zvariant::Value::Structure(_)));
assert!(matches!(fields[2], zvariant::Value::Array(_)));
let reply_msg = Message::method_reply(None::<&str>, &message, &body)?;
let reply_value : (i32, (i32, &str), Vec<String>) = reply_msg.body()?;
assert_eq!(reply_value.0, 7);
assert_eq!(reply_value.2.len(), 1);
Get a reference to the byte encoding of the message.
Get a reference to the byte encoding of the body of the message.
Get the receive ordering of a message.
This may be used to identify how two events were ordered on the bus. It only produces a
useful ordering for messages that were produced by the same zbus::Connection
.
This is completely unrelated to the serial number on the message, which is set by the peer and might not be ordered at all.