/usr/share/perl5/Magpie/Event/Symbol.pm is in libmagpie-perl 1.140280-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 | package Magpie::Event::Symbol;
{
$Magpie::Event::Symbol::VERSION = '1.140280';
}
# ABSTRACT: Role implementing the common symbol table interface.
use Moose::Role;
requires qw(default_symbol_table);
has symbol_table => (
is => 'rw',
isa => 'Magpie::SymbolTable',
builder => 'default_symbol_table',
handles => [qw(has_symbol reset_symbol reset_table add_symbol get_symbol)],
);
#-------------------------------------------------------------------------------
# reset_symbol_handler( $symbol_name )
# Empties out the list of handler subs associated with $symbol_name in the
# symbol table.
#-------------------------------------------------------------------------------
sub reset_symbol_handler {
my $self = shift;
my $symbol = shift;
if ( defined $symbol
and length $symbol )
{
if ( $self->has_symbol($symbol) ) {
$self->reset_symbol($symbol);
}
}
else {
$self->reset_table;
}
}
#-------------------------------------------------------------------------------
# add_symbol_handler( $symbol_name, $coderef )
# Adds the event sub ($coderef) to the entry in the symbol table associated
# with $symbol_name.
#-------------------------------------------------------------------------------
sub add_symbol_handler {
my $self = shift;
my $symbol = shift;
my $handler = shift;
$symbol = $self->_qualify_symbol_name($symbol);
unless (defined $symbol
and length $symbol
and defined $handler
and ref($handler) eq 'CODE' )
{
die 'add_symbol_handler( $symbol_name => $coderef )';
}
return $self->add_symbol( $symbol, $handler );
}
#-------------------------------------------------------------------------------
# get_symbol_handler( $symbol_name )
# Returns the list of handler subs associated with $symbol_name in the
# symbol table.
#-------------------------------------------------------------------------------
sub get_symbol_handler {
my $self = shift;
my $symbol = shift;
$symbol = $self->_qualify_symbol_name($symbol);
if ( defined $symbol
and length $symbol )
{
if ( $self->has_symbol($symbol) ) {
return @{ $self->get_symbol($symbol) };
}
}
warn("Unregistered Symbol: $symbol");
return undef;
}
sub _qualify_symbol_name {
my $self = shift;
my $symbol = shift;
return $symbol if $symbol =~ /\./;
my $pkg = $self->meta->name;
return $pkg . '.' . $symbol;
}
# SEEALSO: Magpie, Magpie::SymbolTable
1;
__END__
=pod
=head1 NAME
Magpie::Event::Symbol - Role implementing the common symbol table interface.
=head1 VERSION
version 1.140280
=head1 AUTHORS
=over 4
=item *
Kip Hampton <kip.hampton@tamarou.com>
=item *
Chris Prather <chris.prather@tamarou.com>
=back
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Tamarou, LLC.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|