io::async::loop::glib(3pm) [debian man page]

IO::Async::Loop::Glib(3pm)				User Contributed Perl Documentation				IO::Async::Loop::Glib(3pm)

NAME

       "IO::Async::Loop::Glib" - use "IO::Async" with Glib or GTK

SYNOPSIS

	use IO::Async::Loop::Glib;

	my $loop = IO::Async::Loop::Glib->new();

	$loop->add( ... );

	...
	# Rest of GLib/Gtk program that uses GLib

	Glib::MainLoop->new->run();

       Or

	$loop->loop_forever();

       Or

	while(1) {
	   $loop->loop_once();
	}

DESCRIPTION

       This subclass of "IO::Async::Loop" uses the "Glib::MainLoop" to perform read-ready and write-ready tests.

       The appropriate "Glib::IO" sources are added or removed from the "Glib::MainLoop" when notifiers are added or removed from the set, or when
       they change their "want_writeready" status. The callbacks are called automatically by Glib itself; no special methods on this loop object
       are required.

CONSTRUCTOR

   $loop = IO::Async::Loop::Glib->new()
       This function returns a new instance of a "IO::Async::Loop::Glib" object. It takes no special arguments.

METHODS

       There are no special methods in this subclass, other than those provided by the "IO::Async::Loop" base class.

   $count = $loop->loop_once( $timeout )
       This method calls the "iteration()" method on the underlying "Glib::MainContext". If a timeout value is supplied, then a Glib timeout will
       be installed, to interrupt the loop at that time. If Glib indicates that any callbacks were fired, then this method will return 1 (however,
       it does not mean that any "IO::Async" callbacks were invoked, as there may be other parts of code sharing the Glib main context. Otherwise,
       it will return 0.

SEE ALSO

       o   Glib - Perl wrappers for the GLib utility and Object libraries

       o   Gtk2 - Perl interface to the 2.x series of the Gimp Toolkit library

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.14.2							    2013-03-01						IO::Async::Loop::Glib(3pm)

IO::Async::DetachedCode(3pm)				User Contributed Perl Documentation			      IO::Async::DetachedCode(3pm)

NAME

       "IO::Async::DetachedCode" - execute code asynchronously in child processes

SYNOPSIS

       This object is used indirectly via the "IO::Async::Loop"'s "detach_code" method.

	use IO::Async::Loop;
	my $loop = IO::Async::Loop->new;

	my $code = $loop->detach_code(
	   code => sub {
	      my ( $number ) = @_;
	      return is_prime( $number );
	   }
	);

	$code->call(
	   args => [ 123454321 ],
	   on_return => sub {
	      my $isprime = shift;
	      print "123454321 " . ( $isprime ? "is" : "is not" ) . " a prime number
";
	   },
	   on_error => sub {
	      print STDERR "Cannot determine if it's prime - $_[0]
";
	   },
	);

	$loop->run;

DESCRIPTION

       This object class provides a legacy compatibility layer for existing code that tries to construct such an object. It should not be used for
       new code; see instead the IO::Async::Function object, for which this is now a wrapper.

CONSTRUCTOR

   $code = $loop->detach_code( %params )
       This function returns a new instance of a "IO::Async::DetachedCode" object.  The %params hash takes the following keys:

       code => CODE
	       A block of code to call in the child process.

       stream
       marshaller
	       These arguments are no longer used; any values passed will be ignored.

       workers => INT
	       Optional integer, specifies the number of parallel workers to create.

	       If not supplied, 1 is used.

       exit_on_die => BOOL
       setup => ARRAY
	       Passed through to the underlying "IO::Async::Function" object.

METHODS

   $code->call( %params )
       Calls one invocation of the contained function code block. See the "call" method on "IO::Async::Function" for more detail.

   $code->shutdown
       This method requests that the detached worker processes stop running.

   $n_workers = $code->workers
       This method in scalar context returns the number of workers currently running.

   @worker_pids = $code->workers
       This method in list context returns a list of the PID numbers of all the currently running worker processes.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.14.2							    2012-10-24					      IO::Async::DetachedCode(3pm)