NAME
Math::ModInt::Event::Trap - catching events triggered by Math::ModInt
VERSION
This documentation refers to version 0.013 of Math::ModInt::Event::Trap.
SYNOPSIS
# event consumer interface:
use Math::ModInt::Event::Trap;
sub my_handler {
my ($event) = @_;
# ... insert code here ...
return 0; # call no handler after this one
return 1; # continue calling subsequent handlers
}
$trap = Math::ModInt::Event::Trap->new($event, \&my_handler);
$trap = Math::ModInt::Event::Trap->new($event, 'ignore');
$trap = Math::ModInt::Event::Trap->new($event, 'warn');
$trap = Math::ModInt::Event::Trap->new($event, 'die');
undef $trap; # discard this trap
Math::ModInt::Event::Trap->new($event, \&my_handler);
Math::ModInt::Event::Trap->new($event, 'ignore');
Math::ModInt::Event::Trap->new($event, 'warn');
Math::ModInt::Event::Trap->new($event, 'die');
# event producer interface:
Math::ModInt::Event::Trap->broadcast($event);DESCRIPTION
This module is closely related to Math::ModInt::Event and should in general not be directly accessed from application code. Please refer to Math::ModInt::Event for a more user-friendly description of both module's functionalities.
Class Methods
- new
-
Constructor, takes an event object, and a handler coderef or a generic handler name. Returns the new trap object.
- broadcast
-
Notifies active event handlers of an event. Takes an event, returns the number of handlers called.
EXPORT
Math::ModInt::Event::Trap has no exports.
DIAGNOSTICS
Standard warning handlers print "warning: " and the short description of the event (like "undefined result") on STDERR, followed by a caller source code location.
Standard error handlers die with "error: " and the short description of the event (like "undefined result").
SEE ALSO
AUTHOR
Martin Becker, <becker-cpan-mp at cozap.com>
LICENSE AND COPYRIGHT
Copyright (c) 2010-2021 Martin Becker, Blaubeuren.
This library is free software; you can distribute it and/or modify it under the terms of the Artistic License 2.0 (see LICENSE file). at your option, any later version of Perl 5 you may have available.
DISCLAIMER OF WARRANTY
This library is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.