Net::DB...Callback(3)

💖 NAME 💖

okay bestie, welcome to Net::DBus::Callback(3) — the little module from the User Contributed Perl Documentation corner that's literally a callback for receiving reactor events. That's the whole vibe: Net::DBus::Callback = a callback for receiving reactor events. 💅

---

🌸 SYNOPSIS 🌸

Here's the group-chat demo, no cap:

  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 is lowkey just a tiny container for storing the deets about a callback you wanna invoke at a later date. It gets used when you're registering to receive events from the Net::DBus::Reactor class.

NB, bestie: using 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. Periodt. ✨

---

🎀 METHODS 🎀

• my $cb = Net::DBus::Callback->new(method => $name, [args => \@args]) — makes 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 passed to the callback, in addition to those passed into the "invoke" method. 🫶
• my $cb = Net::DBus::Callback->new(object => $object, method => $name, [args => \@args]) — makes 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 passed 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

---

okay bye bestie, this page was served by perl v5.42.0, dated 2019-12-17 — mwah 💋