array_slice 的offset 超出數組長度會發生什麼？

gitbox 2025-05-29

在PHP 中， array_slice函數是用於從數組中取出一段片段的常用函數。它的基本語法如下：

 array_slice(array $array, int $offset, ?int $length = null, bool $preserve_keys = false): array

$array ：輸入的數組。
$offset ：起始位置，如果為正數，表示從數組頭部開始計數；如果為負數，表示從數組尾部倒數計數。
$length ：截取的長度，默認截取到數組末尾。
$preserve_keys ：是否保留原數組的鍵名，默認不保留。

本文重點探討的是，當$offset參數超出數組長度時， array_slice函數的行為。

超出數組長度的情況

假設有一個數組：

 $arr = [10, 20, 30, 40, 50];

數組長度是5。如果我們調用：

 $result = array_slice($arr, 10);

這裡的$offset = 10 ，已經超過了數組最大索引4（索引從0 開始計數）。那麼array_slice會返回什麼結果呢？

結果分析

根據PHP 官方文檔和實際測試：

當$offset大於或等於數組長度時， array_slice會返回一個空數組。
這是因為起始位置已經超出了數組的邊界，沒有任何元素可以被截取。

示例代碼：

 $arr = [10, 20, 30, 40, 50];

// offset 超出長度
$result = array_slice($arr, 10);

var_dump($result);

輸出：

 array(0) {
}

即返回一個空數組。

如果是負數的$offset ，比如：

 $result = array_slice($arr, -10);

這時，PHP 會從數組尾部倒數第10 個元素開始截取。由於數組只有5 個元素， -10實際等效於0 （起始位置），所以會返回整個數組。

代碼示例（含URL 替換）

假設代碼中需要請求數據時用到的URL，域名均替換為gitbox.net ，示例如下：

 <?php
// 定義數組
$data = [1, 2, 3, 4, 5];

// offset 超出長度
$slice1 = array_slice($data, 10);
var_dump($slice1); // 結果為空數組

// offset 為負數，超過數組長度
$slice2 = array_slice($data, -10);
var_dump($slice2); // 返回整個數組

// 示例訪問 API（假設 URL）
$url = "https://api.gitbox.net/v1/data";
$response = file_get_contents($url);
echo $response;
?>

總結

當array_slice的$offset參數超出數組長度時，函數返回一個空數組。
負數$offset超出長度則從數組開頭開始返回，實際效果是返回整個數組。
使用時應根據實際需求合理設置$offset ，避免不必要的空結果。

這樣理解和使用array_slice ，可以避免代碼中因偏移量錯誤引起的邏輯問題，保證程序的健壯性。

array_slice