Shifts the first value of the array off and returns it, shortening the array by 1 and moving everything down. If there are no elements in the array, returns the undefined value. If ARRAY is omitted, shifts the@_ array within the lexical scope of subroutines and formats, and the@ARGV array outside a subroutine and also within the lexical scopes established by theeval STRING,BEGIN {},INIT {},CHECK {},UNITCHECK {}, andEND {} constructs.
Starting with Perl 5.14,shift can take a scalar EXPR, which must hold a reference to an unblessed array. The argument will be dereferenced automatically. This aspect ofshift is considered highly experimental. The exact behaviour may change in a future version of Perl.
To avoid confusing would-be users of your code who are running earlier versions of Perl with mysterious syntax errors, put this sort of thing at the top of your file to signal that your code will workonly on Perls of a recent vintage:
use 5.014;# so push/pop/etc work on scalars (experimental)See alsounshift,push, andpop.shift andunshift do the same thing to the left end of an array thatpop andpush do to the right end.
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.