array_shift

(PHP 4, PHP 5, PHP 7)

array_shiftShift an element off the beginning of array

Descrierea

array_shift ( array &$array ) : mixed

array_shift() shifts the first value of the array off and returns it, shortening the array by one element and moving everything down. All numerical array keys will be modified to start counting from zero while literal keys won't be affected.

Notă: Această funcție va reseta (reset()) indicatorul tabloului (array) de intrare după utilizare.

Parametri

array

The input array.

Valorile întoarse

Returns the shifted value, or NULL if array is empty or is not an array.

Exemple

Example #1 array_shift() example

<?php
$stack 
= array("orange""banana""apple""raspberry");
$fruit array_shift($stack);
print_r($stack);
?>

Exemplul de mai sus va afișa:

Array
(
    [0] => banana
    [1] => apple
    [2] => raspberry
)

and orange will be assigned to $fruit.

A se vedea și

  • array_unshift() - Prepend one or more elements to the beginning of an array
  • array_push() - Push one or more elements onto the end of array
  • array_pop() - Pop the element off the end of array