=over

=item push ARRAY,LIST
X<push> X<stack>

Adds one or more items to the B<end> of an array.

	my @animals = ("cat");
	push(@animals, "mouse"); # ("cat", "mouse")

	my @colors = ("red");
	push(@colors, ("blue", "green")); # ("red", "blue", "green")

Returns the number of elements in the array following the completed
L<C<push>|/push ARRAY,LIST>.

	my $color_count = push(@colors, ("yellow", "purple"));

	say "There are $color_count colors in the updated array";

Starting with Perl 5.14, an experimental feature allowed
L<C<push>|/push ARRAY,LIST> to take a
scalar expression. This experiment has been deemed unsuccessful, and was
removed as of Perl 5.24.

=back