Jon Portnoy > List-Objects-WithUtils-2.010001 > List::Objects::WithUtils::Autobox

Download:
List-Objects-WithUtils-2.010001.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 2.010001   Source   Latest Release: List-Objects-WithUtils-2.014002

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>

syntax highlighting: