Net::DB...yncReply(3)

💖 Net::DBus::ASyncReply(3) — User Contributed Perl Documentation 💖

okay bestie, this is the User Contributed Perl Documentation page for Net::DBus::ASyncReply(3). The header line shows the truncated Net::DB...yncReply(3) version, so don't panic — same page, same icon, just a lil cropped 💅

---

🌸 NAME 🌸

Net::DBus::ASyncReply — asynchronous method reply handler. It's giving "your remote call went out and this object is holding the reply for you" energy 🦋

✨ SYNOPSIS ✨

use Net::DBus::Annotation qw(:call);

my $object = $service->get_object("/org/example/systemMonitor");

# List processes & get on with other work until
# the list is returned.
my $asyncreply = $object->list_processes(dbus_call_async, "someuser");

while (!$asyncreply->is_ready) {
  ... do some background work..
}

my $processes = $asyncreply->get_result;

🎀 DESCRIPTION 🎀

This object is your handler for receiving asynchronous method replies. You get an asynchronous reply object when you make a remote method call with the dbus_call_async annotation set. Literally the main character of "go do other stuff while the reply cooks" 🌈

💅 METHODS 💅

$asyncreply->discard_result;

Indicates that the caller is no longer interested in receiving the reply & that it should be discarded. After calling this method, this object should not be used again.

🚨 bestie, after this one the object is done — do not use it again.

$asyncreply->wait_for_result;

Blocks you — the caller — while it waits for completion of the of the asynchronous reply. Once this method returns, the result can be obtained with the get_result method.

💀 yes, the double "of the" is in the original. We keep the lore.

my $boolean = $asyncreply->is_ready;

Returns a true value if the asynchronous reply is now complete (or a timeout has occurred). When this method returns true, the result can be obtained with the get_result method.

$asyncreply->set_notify($coderef);

Sets a notify function which will be invoked when the asynchronous reply finally completes. The callback will be invoked with a single parameter which is this object.

my @data = $asyncreply->get_result;

Retrieves the data associated with the asynchronous reply. If a timeout occurred, then this method will throw an exception. This method can only be called once the reply is complete, as indicated by the is_ready method returning a true value. After calling this method, this object should no longer be used.

😭 timeout? exception. not ready yet? can't call it. already called it? object's retired. rules are rules, bestie.

🌈 AUTHOR 🌈

Daniel Berrange <dan@berrange.com>

🍓 COPYRIGHT 🍓

Copright (C) 2006-2011, Daniel Berrange.

🧚 SEE ALSO 🧚

• Net::DBus
• Net::DBus::RemoteObject
• Net::DBus::Annotation

---

okay that's the whole page! this absolute icon is from perl v5.42.0, dated 2019-12-17, and its manual page tag is Net::DB...yncReply(3). bye bestie, go make those async calls slay 💖✨🦋