| 1 | ==============================================================================
|
|---|
| 2 | Release of version 0.60 of NEXT
|
|---|
| 3 | ==============================================================================
|
|---|
| 4 |
|
|---|
| 5 |
|
|---|
| 6 | NAME
|
|---|
| 7 |
|
|---|
| 8 | NEXT - Pseudo class for method redispatch
|
|---|
| 9 |
|
|---|
| 10 |
|
|---|
| 11 | DESCRIPTION
|
|---|
| 12 |
|
|---|
| 13 | NEXT.pm adds a pseudoclass named C<NEXT> to any program that
|
|---|
| 14 | uses it. If a method C<m> calls C<$self->NEXT::m()>, the call to
|
|---|
| 15 | C<m> is redispatched as if the calling method had not originally
|
|---|
| 16 | been found.
|
|---|
| 17 |
|
|---|
| 18 | In other words, a call to C<$self->NEXT::m()> resumes the
|
|---|
| 19 | depth-first, left-to-right search of parent classes that
|
|---|
| 20 | resulted in the original call to C<m>.
|
|---|
| 21 |
|
|---|
| 22 | Note that this is not the same thing as C<$self->SUPER::m()>, which
|
|---|
| 23 | begins a new dispatch that is restricted to searching the ancestors
|
|---|
| 24 | of the current class. C<$self->NEXT::m()> can backtrack past
|
|---|
| 25 | the current class -- to look for a suitable method in other
|
|---|
| 26 | ancestors of C<$self> -- whereas C<$self->SUPER::m()> cannot.
|
|---|
| 27 |
|
|---|
| 28 | An particularly interesting use of redispatch is in
|
|---|
| 29 | C<AUTOLOAD>'ed methods. If such a method determines that it is
|
|---|
| 30 | not able to handle a particular call, it may choose to
|
|---|
| 31 | redispatch that call, in the hope that some other C<AUTOLOAD>
|
|---|
| 32 | (above it, or to its left) might do better.
|
|---|
| 33 |
|
|---|
| 34 | The module also allows you to specify that multiply inherited
|
|---|
| 35 | methods should only be redispatched once, and what should
|
|---|
| 36 | happen if no redispatch is possible.
|
|---|
| 37 |
|
|---|
| 38 |
|
|---|
| 39 | AUTHOR
|
|---|
| 40 |
|
|---|
| 41 | Damian Conway (damian@conway.org)
|
|---|
| 42 |
|
|---|
| 43 |
|
|---|
| 44 | COPYRIGHT
|
|---|
| 45 |
|
|---|
| 46 | Copyright (c) 2000-2001, Damian Conway. All Rights Reserved.
|
|---|
| 47 | This module is free software. It may be used, redistributed
|
|---|
| 48 | and/or modified under the same terms as Perl itself.
|
|---|
| 49 |
|
|---|
| 50 |
|
|---|
| 51 | ==============================================================================
|
|---|
| 52 |
|
|---|
| 53 | CHANGES IN VERSION 0.60
|
|---|
| 54 |
|
|---|
| 55 |
|
|---|
| 56 | - Re-re-re-fixed NEXT::UNSEEN bug under diamond inheritance
|
|---|
| 57 | (Note to self: don't code whilst on vacation!)
|
|---|
| 58 |
|
|---|
| 59 | - Implemented and documented EVERY functionality
|
|---|
| 60 |
|
|---|
| 61 |
|
|---|
| 62 | ==============================================================================
|
|---|
| 63 |
|
|---|
| 64 | AVAILABILITY
|
|---|
| 65 |
|
|---|
| 66 | NEXT has been uploaded to the CPAN
|
|---|
| 67 |
|
|---|
| 68 | ==============================================================================
|
|---|
