五大核心函數速查
| 函數 | 功能 | 是否修改原陣列 | 返回值 |
array_slice() | 截取陣列片段 | 否 | 新陣列(片段) |
array_search() | 搜尋值返回鍵名 | 否 | 找到的鍵名 / false |
array_shift() | 移除並返回第一個元素 | 是(重新索引) | 被移除的值 |
array_unique() | 移除重複值 | 否 | 新陣列(保留第一次出現的鍵) |
array_unshift() | 開頭插入元素 | 是(重新索引) | 新陣列長度 |
array_slice():靈活截取片段
$input = array('a', 'b', 'c', 'd', 'e');
array_slice($input, 2); // ['c', 'd', 'e'] 從索引 2 到結尾
array_slice($input, -2, 1); // ['d'] 倒數第 2 起取 1 個
array_slice($input, 0, 3); // ['a', 'b', 'c'] 從開頭取 3 個
array_slice($input, 2, -1); // ['c', 'd'] 索引 2 到倒數第 2(不含)
array_slice($input, 2, -1, true); // ['c'=>'c', 'd'=>'d'] 保留鍵名(第 4 參數 true)
參數說明
array_slice(array $array, int $offset, int $length = null, bool $preserve_keys = false)
$offset ≥ 0:從開頭;< 0:從結尾倒數
$length > 0:最大長度;< 0:結尾省略;null:到結尾
$preserve_keys:true 保留原鍵名(關聯陣列適用)
array_search():搜尋值對應鍵名
$array = array('blue', 'red', 'green', 'red');
$key = array_search('green', $array); // 2(找到第一個)
$key = array_search('red', $array); // 1(僅返回第一個匹配)
// 嚴格模式(PHP 4.2+)
array_search('1', [1, 2], true); // false(字串 !== 整數)
array_search(1, [1, 2], true); // 0
// 找所有匹配鍵名
$keys = array_keys($array, 'red'); // [1, 3]
array_shift():隊列式取出首元素
$array = array('orange', 'banana', 'apple', 'raspberry');
$result = array_shift($array);
echo $result; // orange
print_r($array); // [0=>'banana', 1=>'apple', 2=>'raspberry'](重新索引)
// 空陣列呼叫返回 null,不報錯
array_unique():去除重複值
$input = array('a'=>'green', 'red', 'b'=>'green', 'blue', 'red');
$result = array_unique($input);
// ['a'=>'green', 0=>'red', 'blue'](保留第一次出現的鍵名)
// 排序後去重(取唯一值不保留鍵)
$values = array_values(array_unique($input));
// ['green', 'red', 'blue']
多維陣列去重(需序列化比較)
$data = [
['id'=>1, 'name'=>'A'],
['id'=>2, 'name'=>'B'],
['id'=>1, 'name'=>'A'], // 重複
];
$unique = array_map('unserialize', array_unique(array_map('serialize', $data)));
// 結果:保留前兩筆
array_unshift():陣列開頭插入元素
$array = array('orange', 'banana');
$result = array_unshift($array, 'apple', 'raspberry');
echo $result; // 4(新長度)
print_r($array); // [0=>'apple', 1=>'raspberry', 2=>'orange', 3=>'banana']
組合應用:實作簡單隊列/堆疊
class SimpleQueue {
private $data = [];
public function enqueue($value) { // 入隊
array_push($this->data, $value);
}
public function dequeue() { // 出隊
return array_shift($this->data);
}
public function peek() { // 查看隊首
return $this->data[0] ?? null;
}
public function isEmpty() {
return empty($this->data);
}
}
$q = new SimpleQueue();
$q->enqueue('task1');
$q->enqueue('task2');
echo $q->dequeue(); // task1
echo $q->dequeue(); // task2
效能提示
- `array_shift()` / `array_unshift()` 需重新索引,大陣列頻繁操作效能較差
- 高頻率隊列操作建議用 `SplQueue` / `SplStack`(SPL 內建,O(1) 操作)
- `array_slice()` 不修改原陣列,記憶體用量大時注意複製開銷