Perl::Critic::Policy::SUPuseberrrlo:uC:toCinrntiertsii:bc:u:Pt:rePodohliPibecirytl:R:eDStouucbrurnmoSeuontrtitan(te3is)o:n:ProhibitReturnSort(3)



NNAAMMEE
       Perl::Critic::Policy::Subroutines::ProhibitReturnSort - Behavior of
       "sort" is not defined if called in scalar context.

AAFFFFIILLIIAATTIIOONN
       This Policy is part of the core Perl::Critic distribution.

DDEESSCCRRIIPPTTIIOONN
       The behavior of the builtin "sort" function is not defined if called in
       scalar context.  So if you write a subroutine that directly "return"s
       the result of a "sort" operation, then you code will behave
       unpredictably if someone calls your subroutine in a scalar context.
       This Policy emits a violation if the "return" keyword is directly
       followed by the "sort" function.  To safely return a sorted list of
       values from a subroutine, you should assign the sorted values to a
       temporary variable first.  For example:

          sub frobulate {

              return sort @list;  # not ok!

              @sorted_list = sort @list;
              return @sort        # ok
          }

KKNNOOWWNN BBUUGGSS
       This Policy is not sensitive to the "wantarray" function.  So the
       following code would generate a false violation:

          sub frobulate {

              if (wantarray) {
                  return sort @list;
              }
              else{
                  return join @list;
              }
          }

CCOONNFFIIGGUURRAATTIIOONN
       This Policy is not configurable except for the standard options.

CCRREEDDIITTSS
       This Policy was suggested by Ulrich Wisser and the <http://iis.se>
       team.

AAUUTTHHOORR
       Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

CCOOPPYYRRIIGGHHTT
       Copyright (c) 2005-2010 Imaginative Software Systems.  All rights
       reserved.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  The full text of this license can
       be found in the LICENSE file included with this module.



perl v5.12.2          Perl::Critic2:0:1P1o-l0i8c-y1:4:Subroutines::ProhibitReturnSort(3)
