函式名稱:Ds\Vector::shift()
函式描述:這個函式用於從向量的開頭移除並返回第一個元素。
引數:無
返回值:成功地從向量的開頭移除並返回第一個元素,如果向量為空則返回NULL。
適用版本:這個方法是在PHP版本7.1.0及以上的Ds擴充套件中引入的。
用法示例:
<?php
use Ds\Vector;
$vector = new Vector([1, 2, 3]);
$firstElement = $vector->shift();
var_dump($firstElement); // 輸出: int(1)
var_dump($vector->toArray()); // 輸出: array(2) { [0]=> int(2) [1]=> int(3) }
$emptyVector = new Vector();
$nullElement = $emptyVector->shift();
var_dump($nullElement); // 輸出: NULL
var_dump($emptyVector->isEmpty()); // 輸出: bool(true)
?>
在示例中,我們首先建立一個包含數字1、2和3的向量。然後,我們使用shift()
方法將第一個元素1從向量中移除並賦值給變數$firstElement
。然後,我們透過呼叫toArray()
方法來檢查向量的剩餘元素,輸出為[2, 3]
。接下來,我們建立一個空向量,並使用shift()
方法移除第一個元素,由於向量為空,所以返回值為NULL,並透過呼叫isEmpty()
方法檢查向量是否為空,輸出為true。