NAME

       List::Objects::WithUtils::Autobox - Native data types WithUtils

SYNOPSIS

         use List::Objects::WithUtils 'autobox';

         my @upper = [ qw/foo bar baz/ ]->map(sub { uc })->all;

         my @sorted_keys = { foo => 'bar', baz => 'quux' }->keys->sort->all;

         # See List::Objects::WithUtils::Role::Array
         # and List::Objects::WithUtils::Role::Hash

DESCRIPTION

       This module is a subclass of autobox that provides List::Objects::WithUtils methods for
       native ARRAY and HASH types; you can treat native Perl list references as if they were
       List::Objects::WithUtils::Array or List::Objects::WithUtils::Hash instances.

       Like autobox, the effect is lexical in scope and can be disabled:

         use List::Objects::WithUtils::Autobox;
         my $foo = [3,2,1]->sort;

         no List::Objects::WithUtils::Autobox;
         [3,2,1]->sort;  # dies

   CAVEATS
       You can't call new on autoboxed refs (but that would be a silly thing to do anyway -- and
       if you're really determined, "[]->copy" has the same effect).

       It's worth noting that methods that create new lists will return blessed objects, not
       native data types. This lets you continue passing result collections around to other
       pieces of Perl that wouldn't otherwise know how to call the autoboxed methods. (Some
       methods do return the object they were originally operating on, in which case the original
       reference is indeed returned, as expected.)

AUTHOR

       Jon Portnoy <avenj@cobaltirc.org>