Author: lwall Date: 2009-06-12 18:33:26 +0200 (Fri, 12 Jun 2009) New Revision: 27062
Modified: docs/Perl6/Spec/S32-setting-library/Containers.pod Log: [Containers] add @array.rotate, define push and unshift to return array Modified: docs/Perl6/Spec/S32-setting-library/Containers.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Containers.pod 2009-06-12 16:30:25 UTC (rev 27061) +++ docs/Perl6/Spec/S32-setting-library/Containers.pod 2009-06-12 16:33:26 UTC (rev 27062) @@ -15,8 +15,8 @@ Moritz Lenz <mor...@faui2k3.org> Tim Nelson <wayl...@wayland.id.au> Date: 19 Feb 2009 extracted from S29-functions.pod - Last Modified: 5 May 2009 - Version: 7 + Last Modified: 12 May 2009 + Version: 8 The document is a draft. @@ -475,10 +475,24 @@ =item push - our Int multi method push ( @array: *...@values ) is export + our Array multi method push ( @array: *...@values ) is export -Add to the end of C<@array>, all of the subsequent arguments. +Add to the end of C<@array>, all of the subsequent arguments and +returns the array. +=item rotate + + our Array multi method rotate ( @array: Int $n ) is export + +Rotates the array and returns it. A positive rotation of 1 +is defined as: + + @array.push(@array.shift); + +A negative shift of 1 is defined as: + + @array.unshift(@array.pop); + =item shift our Scalar multi method shift ( @array: ) is export @@ -522,9 +536,10 @@ =item unshift - our Int multi method unshift ( @array: *...@values ) is export + our Array multi method unshift ( @array: *...@values ) is export -C<unshift> adds the values onto the start of the C<@array>. +C<unshift> adds the values onto the start of the C<@array> and +returns the array. =item keys