NAME

Aspect::JoinPoint::Sub - Superclass for subroutine-based join points

SYNOPSIS

There is no synopsis, as this class is only used within Aspects; if you develop Aspect internals, you'll know how to use it. If not, you don't need to. If you're curious, read the source.

DESCRIPTION

This class is a superclass for subroutine-based join points, that is, call join points and return join points.

METHODS

This class inherits from Aspect::JoinPoint. In addition, it implements and/or overrides the following methods:

init([STRING])

This method initializes newly constructed objects. The optional argument is handed to sub().

sub([STRING])

Gets or sets (if called with an argument) the name of the subroutine this join points belongs to.

signature(LIST)

Returns a string describing a call to the subroutine given the argument list. This list is expected to come from a Hook::LexWrap wrapper argument list, so the last list element is discarded as it indicates the potential return value. See Hook::LexWrap for details.

This method is useful for tracing subroutine calls.

Example: If the join point's subroutine name is foo and the argument list is (1, 'hello') then the signature would be foo(1, hello).

BUGS

None known so far. If you find any bugs or oddities, please do inform the author.

AUTHOR

Marcel Grunauer, <marcel@codewerk.com>

COPYRIGHT

Copyright 2001 Marcel Grunauer. All rights reserved.

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

SEE ALSO

perl(1), Aspect::Intro(3pm), Aspect::Overview(3pm).