Scroll to navigation

IO::Event::Callback(3) User Contributed Perl Documentation IO::Event::Callback(3)

NAME

IO::Event::Callback - A closure based API for IO::Event

VERSION

version 0.814

SYNOPSIS

 use IO::Event::Callback;
 IO::Event::Callback->new($filehanle, %callbacks);
 use IO::Event::INET::Callback;
 IO::Event::INET::Callback->new(%socket_info, %callbacks);
 use IO::Event::UNIX::Callback;
 IO::Event::UNIX::Callback->new(%socket_info, %callbacks);

DESCRIPTION

IO::Event::Callback is a wrapper around IO::Event. It provides an alternative interface to using IO::Event.

Instead of defining a class with methods like "ie_input", you provide the callbacks as code references when you create the object.

The keys for the callbacks are the same as the callbacks for IO::Event with the "ie_" prefix removed.

CONSTRUCTORS

new

 my $ioe = IO::Event::Callback->new($filehandle, %callbacks);

Create an IO::Event object for $filehandle whose handler invokes the given callbacks. The keys of %callbacks are the IO::Event handler names, with or without the "ie_" prefix (for example "input" or "ie_input"). The "read_only" and "write_only" options are passed through to IO::Event.

EXAMPLE

 use IO::Event::Callback;
 my $remote = IO::Event::Callback::INET->new(
    peeraddr    => '10.20.10.3',
    peerport    => '23',
    input       => sub {
        # handle input
    },
    werror      => sub {
        # handdle error
    },
    eof     => sub {
        # handle end-of-file
    },
 );

SEE ALSO

See the source for RPC::ToWorker for an example use of IO::Event::Callback.

AUTHORS

  • David Muir Sharnoff <cpan@dave.sharnoff.org>
  • Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2002-2026 by David Muir Sharnoff <muir@idiom.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

2026-10-06 perl v5.44.0