routine unshift
Documentation for routine unshift
assembled from the following types:
class Nil
From Nil
(Nil) method unshift
method unshift(*@)
Warns the user that they tried to unshift onto a Nil
.
role Buf
From Buf
(Buf) method unshift
method unshift()
Adds elements at the beginning of the buffer
.unshift( 0 );say .perl; # OUTPUT: «Buf.new(0,1,1,2,3,5,8,13,21,34,55,89)»
class Array
From Array
(Array) routine unshift
Defined as:
multi sub unshift(Array, ** --> Array)multi method unshift(Array: ** --> Array)
Adds the @values
to the start of the array, and returns the modified array. Fails if @values
is a lazy list.
Example:
my = <a b c>;.unshift: 1, 3 ... 11;say ; # OUTPUT: «[(1 3 5 7 9 11) a b c]»
The notes in the documentation for method push apply, regarding how many elements are added to the array.
method prepend is the equivalent for adding multiple elements from one list or array.
class Any
From Any
(Any) method unshift
Defined as:
multi method unshift(--> Array)multi method unshift( --> Array)
Initializes Any variable as empty Array and calls Array.unshift
on it.
my ;say .unshift; # OUTPUT: «[]»say ; # OUTPUT: «[]»my ;say .unshift([1,2,3]); # OUTPUT: «[[1 2 3]]»