dwww Home | Manual pages | Find package

Net::D...allback(3pm) User Contributed Perl Documentation Net::D...allback(3pm)

NAME
       Net::DBus::Callback - a callback for receiving reactor events

SYNOPSIS
         use Net::DBus::Callback;

         # Assume we have a 'terminal' object and its got a method
         # to be invoked every time there is input on its terminal.
         #
         # To create a callback to invoke this method one might use
         my $cb = Net::DBus::Callback->new(object => $terminal,
                                           method => "handle_stdio");

         # Whatever is monitoring the stdio channel, would then
         # invoke the callback, perhaps passing in a parameter with
         # some 'interesting' data, such as number of bytes available
         $cb->invoke($nbytes)

         #... which results in a call to
         #  $terminal->handle_stdio($nbytes)

DESCRIPTION
       This module provides a simple container for storing details about a
       callback to be invoked at a later date. It is used when registering to
       receive events from the Net::DBus::Reactor class. NB use of this module
       in application code is no longer necessary and it remains purely for
       backwards compatibility.  Instead you can simply pass a subroutine code
       reference in any place where a callback is desired.

METHODS
       my $cb = Net::DBus::Callback->new(method => $name, [args => \@args])
           Creates  a  new  callback object, for invoking a plain old function.
           The "method" parameter should be the fully qualified  function  name
           to invoke, including the package name. The optional "args" parameter
           is  an  array reference of parameters to be pass to the callback, in
           addition to those passed into the "invoke" method.

       my $cb = Net::DBus::Callback->new(object => $object, method => $name,
       [args => \@args])
           Creates a new callback object, for invoking a method on  an  object.
           The  "method"  parameter should be the name of the method to invoke,
           while the "object" parameter should be a blessed object on which the
           method will be invoked. The optional "args" parameter  is  an  array
           reference  of  parameters to be pass to the callback, in addition to
           those passed into the "invoke" method.

       $cb->invoke(@args)
           Invokes the callback. The argument list passed to the callback is  a
           combination  of  the arguments supplied in the callback constructor,
           followed by the arguments supplied in the "invoke" method.

AUTHOR
       Daniel P. Berrange.

COPYRIGHT
       Copyright (C) 2004-2011 Daniel P. Berrange

SEE ALSO
       Net::DBus::Reactor

perl v5.40.0                       2024-10-15             Net::D...allback(3pm)

Generated by dwww version 1.16 on Tue Dec 16 06:37:30 CET 2025.