[函数]Parle\Stack::push()函数—用法及示例

函数名：Parle\Stack::push()

适用版本：Parle扩展的版本要求为7.4.0或更高版本。

用法：Parle\Stack::push()函数用于将一个项目推入堆栈（stack）中。

示例：

// 创建一个新的堆栈对象
$stack = new Parle\Stack();

// 将项目推入堆栈
$stack->push("item1");
$stack->push("item2");
$stack->push("item3");

// 获取堆栈的大小
$size = $stack->size(); // 返回3

// 获取堆栈顶部的项目
$topItem = $stack->top(); // 返回"item3"

// 弹出堆栈顶部的项目
$poppedItem = $stack->pop(); // 返回"item3"

// 获取堆栈的大小
$size = $stack->size(); // 返回2

说明：

• 首先，我们创建了一个新的Parle\Stack对象。
• 然后，我们使用push()函数将三个项目（"item1"、"item2"和"item3"）推入堆栈。
• 通过调用size()函数，我们可以获取堆栈的大小，返回值为3。
• 使用top()函数，我们可以获取堆栈顶部的项目，返回值为"item3"。
• 最后，我们使用pop()函数弹出堆栈顶部的项目，返回值为"item3"。再次调用size()函数，返回值为2，说明堆栈中只剩下两个项目。

注意：此示例仅用于演示Parle\Stack::push()函数的用法，实际应用中可能会有更复杂的逻辑和使用场景。