array_shift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_shiftВитягує елемент з початку масиву

Опис

array_shift(array &$array): mixed

array_shift() витягує з початку масиву array елемент та повертає його значення, скорочуючи масив на один елемент. Всі числові ключі масиву будуть перетворені, щоб починати відлік з нуля, тоді як рядкові ключі не зміняться.

Зауваження: Ця функція скидатиме() вказівник array вхідного масиву після використання.

Параметри

array

Вхідний масив.

Значення, що повертаються

Повертає витягнуте значення або null, якщо array є порожнім або не є масивом.

Приклади

Приклад #1 Приклад використання array_shift()

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

Поданий вище приклад виведе:

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

а значення orange буде встановлено в змінну $fruit.

Прогляньте також

  • 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