StackInterface.php
1.21 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<?php
// Copyright (c) Lellys Informática. All rights reserved. See License.txt in the project root for license information.
namespace Easy\Collections;
use BadFunctionCallException;
/**
* Provides functionality to evaluate queries against a specific data source wherein the type of the data is not specified.
*/
interface StackInterface
{
/**
* Inserts an object at the top of the Stack.
* @param type $item The Object to push onto the Stack. The value <b>can</b> be null.
* @return Stack
*/
public function push($item);
/**
* Inserts multiples objects at the top of the Stack.
* @param CollectionInterface|array $items The Objects to push onto the Stack. The value <b>can</b> be null.
* @return Stack
*/
public function pushMultiple($items);
/**
* Removes and returns the object at the top of the Stack.
* @return mixed The Object removed from the top of the Stack.
* @throws BadFunctionCallException
*/
public function pop();
/**
* Returns the object at the top of the Stack without removing it.
* @return mixed The Object at the top of the Stack.
* @throws BadFunctionCallException
*/
public function peek();
}