Net::DBus::Binding::PendingCall Methods

From Alteeve Wiki
Revision as of 02:47, 12 October 2009 by Digimer (talk | contribs) (Created page with '{{dbtut_header}} = new = Usage: <source lang="perl"> my $method_call=""; # Net::DBus::Binding::Message::MethodCall object. my $pending_call=""; # Raw 'C' Pending Cal…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

 AN!Tools :: Net::DBus Binding Tutorial :: Net::DBus::Binding::PendingCall Methods

new

Usage:

my $method_call="";       # Net::DBus::Binding::Message::MethodCall object.
my $pending_call="";      # Raw 'C' Pending Call object.
my $call = Net::DBus::Binding::PendingCall->new(
        method_call  => $method_call,
        pending_call => $pending_call);

This creates a new 'PendingCall' object where '$method_call' is a reference to a 'Net::DBus::Binding::MethodCall' object and '$pending_call' is a reference to the raw C pending call object.

new

Usage:

my $method_call="";       # Net::DBus::Binding::Message::MethodCall object.
my $pending_call="";      # Raw 'C' Pending Call object.
my $call = Net::DBus::Binding::PendingCall->new(
        method_call  => $method_call,
        pending_call => $pending_call);

This creates a new 'PendingCall' object where '$method_call' is a reference to a 'Net::DBus::Binding::MethodCall' object and '$pending_call' is a reference to the raw C pending call object.

cancel

Usage:

$call->cancel;

This cancels the pending call referenced by '$call'. Any reply that may come later will be discarded.

get_completed

Usage:

my $boolean=$call->get_completed;

This checks if the reply (or timeout) has been received by the pending call referenced by '$call', returning '1' if so, '0' otherwise.

block

Usage:

$call->block;

This pauses until a reply (or timeout) has been received by the pending call referenced by '$call'.

get_reply

Usage:

my $message=$call->get_reply;

This reads the returned message once it has been received. This message is an 'Net::DBus::Binding::Message' object associated with the completed '$call' pending call.

set_notify

Usage:

my $coderef=\&some_routine;
$call->set_notify($coderef);

When the message is returned for the '$call' pending call, the code referenced by '$coderef' will be called. The called code will be passed the pending call object '$call' as the sole argument.

 

Any questions, feedback, advice, complaints or meanderings are welcome.
Alteeve's Niche! Enterprise Support:
Alteeve Support
Community Support
© Alteeve's Niche! Inc. 1997-2024   Anvil! "Intelligent Availability®" Platform
legal stuff: All info is provided "As-Is". Do not use anything here unless you are willing and able to take responsibility for your own actions.