array_shift()

1. 定义

与函数array_pop()相反,该函数将数组开头的元素删除,并返回被删除的第一个元素。

注:

  • 该函数将改变原数组的长度
  • 删除第一个元素后,数组中的数字索引将被重新排序,其他类型的索引不受影响

2. 语法

array_shift ( array &$array ) : mixed

3. 参数说明

参数 可选性 数据类型 描述
$array 必需 数组 待删除第一个元素的数组

4. 示例

<?php

// array_shift()
// 将数组开头的元素删除,并返回被删除的第一个元素

$arr = [1, 2, 3, 4, 5];
$first_element = array_shift($arr);
var_dump($first_element);// 输出:int(1)
var_dump($arr);
/* 输出:
array(4) {
  [0]=>
  int(2)
  [1]=>
  int(3)
  [2]=>
  int(4)
  [3]=>
  int(5)
}
*/

5. 延展阅读

  • array_unshift():将一个或多个元素添加至数组的开头,返回添加元素后数组的长度
  • array_push():将一个或多个元素添加至数组的末尾
  • array_pop():删除数组的最后一个元素,返回删除的最后一个元素