Net::DB...dingCall(3)

🌸 NAME 🌸

okay so bestie, you're reading Net::DBus::Binding::PendingCall(3) from the User Contributed Perl Documentation β€” manual name folded in like a lil name tag πŸŽ€ β€” and it is literally a handler for pending method replies πŸ’–.

✨ SYNOPSIS ✨

the whole vibe is: make the call, wait for it, grab the reply πŸ’…

my $call = Net::DBus::Binding::PendingCall->new(method_call => $call,
                                                pending_call => $reply);

# Wait for completion
$call->block;

# And get the reply message
my $msg = $call->get_reply;

πŸ¦‹ DESCRIPTION πŸ¦‹

This object is used when it is necessary to make asynchronous method calls ✨. It provides the means to be notified when the reply is finally received. no cap, that's the whole point 🫢.

πŸ’… METHODS πŸ’…

new β€” constructor

my $call = Net::DBus::Binding::PendingCall->new(method_call =>
$method_call, pending_call => $pending_call);

Creates a new pending call object πŸ’–. The method_call parameter is a reference to the Net::DBus::Binding::Message::MethodCall object whose reply is being waited for. The pending_call parameter is a reference to the raw C pending call object 🧚.

  • $call->cancel β€” Cancel the pending call, causing any reply that is later received to be discarded. bye-bye reply πŸ‘‹πŸ’€.
  • my $boolean = $call->get_completed β€” Returns a true value if the pending call has received its reply, or a timeout has occurred. so you can check the vibe βœ….
  • $call->block β€” Block the caller until the reply is received or a timeout occurs. yes bestie, it will sit there and wait 🫠.
  • my $msg = $call->get_reply; β€” Retrieves the Net::DBus::Binding::Message object associated with the complete call. that's the message, bestie πŸ“¨.
  • $call->set_notify($coderef); β€” Sets a notification function to be invoked when the pending call completes. The callback will be passed a single argument which is this pending call object πŸŽ€.

πŸ‘‘ AUTHOR πŸ‘‘

Daniel P. Berrange. periodt πŸ’….

Copyright (C) 2006-2011 Daniel P. Berrange. keep the receipts 🧾.

πŸ”— SEE ALSO πŸ”—

  • Net::DBus::Binding::Connection
  • Net::DBus::Binding::Message
  • Net::DBus::ASyncReply

these are the linked besties πŸ’–.


okay bye bestie 🫢 β€” this page is from perl v5.42.0, dated 2019-12-17, and the manual footer goes by Net::DB...dingCall(3) (yes, the truncated title is iconic). slay ✨