從數組中移除元素,并用新元素取代它:
array_splice() 函數從數組中移除選定的元素,并用新元素取代它。函數也將返回被移除元素的數組。
提示:如果函數沒有移除任何元素(length=0),則替代數組將從 start 參數的位置插入(參見實例 2)。
注釋:不保留替代數組中的鍵名。
參數 | 描述 |
---|---|
array | 必需。規定數組。 |
start | 必需。數值。規定刪除元素的開始位置。 0 = 第一個元素。 如果該值設置為正數,則從數組中該值指定的偏移量開始移除。如果該值設置為負數,則從數組末端倒數該值指定的偏移量開始移除。 -2 意味著從數組的倒數第二個元素開始。 |
length | 可選。數值。規定被移除的元素個數,也是被返回數組的長度。 如果該值設置為正數,則移除該數量的元素。如果該值設置為負數,則移除從 start 到數組末端倒數 length 為止中間所有的元素。如果該值未設置,則移除從 start 參數設置的位置開始直到數組末端的所有元素。 |
array | 可選。規定帶有要插入原始數組中元素的數組。如果只有一個元素,則可以設置為字符串,不需要設置為數組。 |
返回值: | 返回包含被提取元素的數組。 |
---|---|
PHP 版本: | 4+ |
與本頁前面部分的實例相同,但是輸出返回的數組:
帶有設置為 0 的 length 參數: