/usr/share/perl5/Magpie/Event/Symbol.pm is in libmagpie-perl 1.141660-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 | package Magpie::Event::Symbol;
$Magpie::Event::Symbol::VERSION = '1.141660';
# 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.141660
=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
|