fpp

[gitmo/Moose-Autobox.git] / lib / Moose / Autobox / Array.pm

diff --git a/lib/Moose/Autobox/Array.pm b/lib/Moose/Autobox/Array.pm
index 6bfda4a..03dc46b 100644 (file)
--- a/lib/Moose/Autobox/Array.pm
+++ b/lib/Moose/Autobox/Array.pm
@@ -1,8 +1,9 @@
 package Moose::Autobox::Array;
 use Moose::Role 'with';
+use Perl6::Junction;
 use autobox;
 
-our $VERSION = '0.01';
+our $VERSION = '0.02';
 
 with 'Moose::Autobox::Ref',
      'Moose::Autobox::List',
@@ -35,7 +36,12 @@ sub delete {
 sub shift { 
     my ($array) = @_;    
     CORE::shift @$array; 
-}     
+}    
+
+sub slice {
+    my ($array, $indicies) = @_;
+    [ @{$array}[ @{$indicies} ] ];
+} 
 
 # NOTE: 
 # sprintf args need to be reversed, 
@@ -111,6 +117,28 @@ sub kv {
     $array->keys->map(sub { [ $_, $array->[$_] ] });
 }
 
+## Junctions
+
+sub all {
+    my ($array) = @_;     
+    return Perl6::Junction::All->all(@$array);
+}
+
+sub any {
+    my ($array) = @_;     
+    return Perl6::Junction::Any->any(@$array);
+}
+
+sub none {
+    my ($array) = @_;     
+    return Perl6::Junction::None->none(@$array);
+}
+
+sub one {
+    my ($array) = @_; 
+    return Perl6::Junction::One->one(@$array);
+}
+
 1;
 
 __END__
@@ -126,49 +154,59 @@ Moose::Autobox::Array - the Array role
   use Moose::Autobox;
   use autobox;
     
+  [ 1..5 ]->isa('ARRAY'); # true
+  [ a..z ]->does('Moose::Autobox::Array'); # true
+  [ 0..2 ]->does('Moose::Autobox::List'); # true  
+    
   print "Squares: " . [ 1 .. 10 ]->map(sub { $_ * $_ })->join(', ');
+  
+  print [ 1, 'number' ]->sprintf('%d is the loneliest %s');
+  
+  print ([ 1 .. 5 ]->any == 3) ? 'true' : 'false'; # prints 'true'
 
 =head1 DESCRIPTION
 
+This is a role to describe operations on the Array type. 
+
 =head1 METHODS
 
 =over 4
 
-=item B<meta>
-
 =item B<pop>
 
-=item B<push>
+=item B<push ($value)>
 
 =item B<shift>
 
-=item B<unshift>
+=item B<unshift ($value)>
 
-=item B<delete>
+=item B<delete ($index)>
 
-=item B<sprintf>
+=item B<sprintf ($format_string)>
+
+=item B<slice (@indices)>
 
 =back
 
-=head2 Indexed
+=head2 Indexed implementation
 
 =over 4
 
-=item B<at>
+=item B<at ($index)>
 
-=item B<put>
+=item B<put ($index, $value)>
 
-=item B<exists>
+=item B<exists ($index)>
 
 =item B<keys>
 
-=item B<kv>
-
 =item B<values>
 
+=item B<kv>
+
 =back
 
-=head2 List
+=head2 List implementation
 
 =over 4
 
@@ -176,17 +214,37 @@ Moose::Autobox::Array - the Array role
 
 =item B<tail>
 
-=item B<join>
+=item B<join (?$seperator)>
 
 =item B<length>
 
-=item B<map>
+=item B<map (\&block)>
 
-=item B<grep>
+=item B<grep (\&block)>
 
 =item B<reverse>
 
-=item B<sort>
+=item B<sort (?\&block)>
+
+=back
+
+=head2 Junctions
+
+=over 4
+
+=item B<all>
+
+=item B<any>
+
+=item B<none>
+
+=item B<one>
+
+=back
+
+=over 4
+
+=item B<meta>
 
 =back
 
@@ -209,4 +267,4 @@ L<http://www.iinteractive.com>
 This library is free software; you can redistribute it and/or modify
 it under the same terms as Perl itself.
 
-=cut
\ No newline at end of file
+=cut