array_shift

(PHP 4, PHP 5)

array_shift — Usuń element z początku tablicy

Opis

mixed array_shift ( array &$tablica )

array_shift() usuwa pierwszą wartość parametru tablica i zwraca go skracając tą tablicę o jeden element przesuwając wszystkie pozostałe elementy w dół. Wszystkie klucze liczbowe zostaną zmodyfikowane tak, aby ich wartości zaczynały się od zera, podczas gdy klucze znakowe nie zostaną zmienione. Jeśli tablica jest pusta (lub nie jest tablicą), zwracana jest wartość NULL.

Informacja: Ta funkcja zresetuje() wskaźnik tablicy po swoim wykonaniu.

Przykład #1 Przykład użycia array_shift()


<?php
$stos = array ("pomarańcza", "banan", "jabłko", "malina");
$owoc = array_shift ($stos);
?>

Zmienna $stos będzie miała 3 elementy:

Array
(
    [0] => banan
    [1] => jabłko
    [2] => malina
)

a pomarańcza będzie przypisana do zmiennej $owoc

Patrz także: array_unshift(), array_push() i array_pop().