=head1 VERSION
-Version 0.20
+Version 0.22
=cut
our $VERSION;
BEGIN {
- $VERSION = '0.20';
+ $VERSION = '0.22';
}
=head1 SYNOPSIS
unwind;
unwind @values, $context;
-Returns C<@values> I<from> the subroutine, eval or format context pointed by or just above C<$context>, and immediately restart the program flow at this point - thus effectively returning C<@values> to an upper scope.
+Returns C<@values> I<from> the subroutine, eval or format context pointed by or just above C<$context>, and immediately restarts the program flow at this point - thus effectively returning C<@values> to an upper scope.
If C<@values> is empty, then the C<$context> parameter is optional and defaults to the current context (making the call equivalent to a bare C<return;>) ; otherwise it is mandatory.
The upper context isn't coerced onto C<@values>, which is hence always evaluated in list context.
yield;
yield @values, $context;
-Returns C<@values> I<from> the context pointed by or just above C<$context>, and immediately restart the program flow at this point.
+Returns C<@values> I<from> the context pointed by or just above C<$context>, and immediately restarts the program flow at this point.
If C<@values> is empty, then the C<$context> parameter is optional and defaults to the current context ; otherwise it is mandatory.
L</yield> differs from L</unwind> in that it can target I<any> upper scope (besides a C<s///e> substitution context) and not necessarily a sub, an eval or a format.
leave @values;
Immediately returns C<@values> from the current block, whatever it may be (besides a C<s///e> substitution context).
-C<leave> is actually a synonym for C<unwind HERE>, while C<leave @values> is a synonym for C<yield @values, HERE>.
+C<leave> is actually a synonym for C<yield HERE>, while C<leave @values> is a synonym for C<yield @values, HERE>.
Like for L</yield>, you can use the fifth value returned by L</context_info> to handle context coercion.
Gives information about the context denoted by C<$context>, akin to what L<perlfunc/caller> provides but not limited only to subroutine, eval and format contexts.
When C<$context> is omitted, it defaults to the current context.
-The values returned are, in order :
+The returned values are, in order :
=over 4
=head1 DEPENDENCIES
-L<perl> 5.6.
+L<perl> 5.6.1.
A C compiler.
This module may happen to build with a C++ compiler as well, but don't rely on it, as no guarantee is made in this regard.
=head1 COPYRIGHT & LICENSE
-Copyright 2008,2009,2010,2011,2012 Vincent Pit, all rights reserved.
+Copyright 2008,2009,2010,2011,2012,2013 Vincent Pit, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.