📜  array_shift (1)

📅  最后修改于: 2023-12-03 15:29:28.432000             🧑  作者: Mango

PHP函数: array_shift

array_shift 是 PHP 中的一个内置函数,用于将数组中的第一个元素删除,并返回被删除元素的值。该函数会修改原数组,使原数组的第一个元素被删除并后面的元素向前移动一个位置。

语法
mixed array_shift ( array &$array )
参数
  • $array:要处理的数组,必须是一个引用类型。
返回值

返回被删除元素的值,如果数组为空则返回 null。

用法示例
<?php
$queue = array("orange", "banana", "apple", "lemon");
$first = array_shift($queue);
print_r($queue);
?>

该示例输出如下结果:

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

在示例中,我们声明了一个 $queue 数组,调用 array_shift($queue) 函数将数组中的第一个元素 "orange" 删除,并将后面的元素 "banana""apple""lemon" 向前移动一个位置。被删除元素的值 "orange" 被赋值给变量 $first

注意事项
  • array_shift 函数只能用于操作数组,不能用于处理其他类型的变量。
  • 索引数组中被删除的元素键名会自动重置为从零开始的递增序列。
  • 如果该函数被用于关联数组,键名不会重新排序,而是保持原样。这意味着被删除的值对应的键名仍旧存在数组中。
  • 如果使用该函数处理空数组,将会返回 null,并且不会修改该数组。
  • 如果要删除数组中的最后一个元素,应该使用 array_pop 函数。