Add one or more elements to thebeginning of an array. This is the opposite of ashift.
my @animals = ("cat");unshift(@animals, "mouse"); # ("mouse", "cat")my @colors = ("red");unshift(@colors, ("blue", "green")); # ("blue", "green", "red")Returns the new number of elements in the updated array.
# Return value is the number of items in the updated arraymy $color_count = unshift(@colors, ("yellow", "purple"));say "There are $color_count colors in the updated array";Note the LIST is prepended whole, not one element at a time, so the prepended elements stay in the same order. Usereverse to do the reverse.
Starting with Perl 5.14, an experimental feature allowedunshift to take a scalar expression. This experiment has been deemed unsuccessful, and was removed as of Perl 5.24.
Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via theGitHub issue tracker oremail regarding any issues with the site itself, search, or rendering of documentation.
The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via thePerl issue tracker, themailing list, orIRC to report any issues with the contents or format of the documentation.