Man pages sections > man3 > Aspect::Pointcut::Highest

Aspect::Pointcut::Highest - Pointcut for preventing recursive matching

Aspect::Pointcut::Highest(3pm) User Contributed Perl Documentation Aspect::Pointcut::Highest(3pm)

NAME

Aspect::Pointcut::Highest - Pointcut for preventing recursive matching

SYNOPSIS

  use Aspect;
  
  # High-level creation
  my $pointcut1 = highest;
  
  # Manual creation
  my $pointcut2 = Aspect::Pointcut::Highest->new;

DESCRIPTION

For aspects including timers and other Aspect::Advice::Around-based advice, recursion can be significant problem.
The "highest" pointcut solves this problem by matching only on the highest invocation of a function. If the function is called again recursively within the first call, at any depth, the deeper calls will be not match and the advice will not be executed.

AUTHORS

Adam Kennedy <adamk@cpan.org>
Marcel Gruenauer <marcel@cpan.org>
Ran Eilam <eilara@cpan.org> Copyright 2001 by Marcel Gruenauer
Some parts copyright 2009 - 2013 Adam Kennedy.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
2013-04-09 perl v5.14.2