PHP - Ds\Stack::pop() 函数



PHP 的 Ds\Stack::pop() 函数用于移除并检索当前栈顶部的值。

众所周知,栈遵循 LIFO(后进先出)原则,最后一个添加的元素将被移除,即栈顶部的元素。如果栈为空 ([]),此函数将抛出“UnderflowException”异常。

语法

以下是 PHP Ds\Stack::pop() 函数的语法:

public Ds\Stack::pop(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回栈顶被移除的值。

示例 1

以下程序演示了 PHP Ds\Stack::pop() 函数的使用:

<?php 
   $stack = new \Ds\Stack([10, 20, 30]);
   echo "The original stack elements are: \n";
   print_r($stack);
   echo "The stack elements after called pop() function: \n";
   #using pop() function
   $stack->pop();
   print_r($stack);
?>

输出

上述程序产生以下输出:

The original stack elements are:
Ds\Stack Object
(
    [0] => 30
    [1] => 20
    [2] => 10
)
The stack elements after called pop() function:
Ds\Stack Object
(
    [0] => 20
    [1] => 10
)

示例 2

以下是 PHP Ds\Stack::pop() 函数的另一个示例。我们使用此函数来移除并检索当前实例的已移除元素。

<?php 
   $stack = new \Ds\Stack(['a', 'e', 'i']);
   $stack->push('o');
   $stack->push('u');
   echo "The original stack elements are: \n";
   print_r($stack);
   #using pop() function
   echo "The removed elements: ";
   print_r($stack->pop());
   echo "\nThe stack elements after pop() function called: \n";
   print_r($stack);
?>

输出

执行上述程序后,将显示以下输出

The original stack elements are:
Ds\Stack Object
(
    [0] => u
    [1] => o
    [2] => i
    [3] => e
    [4] => a
)
The removed elements: u
The stack elements after pop() function called:
Ds\Stack Object
(
    [0] => o
    [1] => i
    [2] => e
    [3] => a
)

示例 3

如果当前栈为空 ([]),此函数将抛出“UnderflowException”异常。

<?php 
   $stack = new \Ds\Stack([ ]);
   echo "The original stack elements are: \n";
   print_r($stack);
   #using pop() function
   echo "The removed elements: ";
   print_r($stack->pop());
   echo "\nThe stack elements after pop() function called: \n";
   print_r($stack);
?>

输出

上述程序抛出以下异常:

The original stack elements are:
Ds\Stack Object
(
)
The removed elements: 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\Stack->pop()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 7
php_function_reference.htm
广告