PHP - Ds Sequence::last() 函式

PHP 的 Ds\Sequence::last() 函式用於檢索序列中的最後一個值。如果當前序列為空 ([])，此函式將丟擲“UnderflowException”異常。

語法

以下是 PHP Ds\Sequence::last() 函式的語法：

abstract public Ds\Sequence::last(): mixed

引數

此函式不接受任何引數。

返回值

此函式返回序列中的最後一個值。

示例 1

以下程式演示了 PHP Ds\Sequence::last() 函式的用法：

<?php 
   $seq = new \Ds\Vector([10, 20, 30, 40, 50]); 
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The last element in a sequence is: ";
   #using last() function
   print_r($seq->last());
?>

輸出

執行上述程式後，將顯示以下輸出：

The sequence elements are:
Ds\Vector Object
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
    [4] => 50
)
The last element in a sequence is: 50

示例 2

以下是 PHP Ds\Sequence::last() 函式的另一個示例。我們使用此函式來檢索此序列 (['a', 'e', 'i', 'o', 'u']) 中的最後一個值：

<?php 
   $seq = new \Ds\Set(['a', 'e', 'i', 'o', 'u']); 
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The last element in a sequence is: ";
   #using last() function
   print_r($seq->last());
?>

輸出

上述程式生成以下輸出：

The sequence elements are:
Ds\Set Object
(
    [0] => a
    [1] => e
    [2] => i
    [3] => o
    [4] => u
)
The last element in a sequence is: u

示例 3

如果當前序列為空 ([])，此函式將丟擲“UnderflowException”異常：

<?php 
   $seq = new \Ds\Vector([]); 
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The last element in a sequence is: ";
   #using last() function
   print_r($seq->last());
?>

輸出

執行上述程式後，將丟擲以下異常：

The sequence elements are:
Ds\Vector Object
(
)
The last element in a sequence is: PHP Fatal error:  Uncaught UnderflowException:
Unexpected empty state in C:\Apache24\htdocs\index.php:7
Stack trace:
#0 C:\Apache24\htdocs\index.php(7): Ds\Vector->last()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 7