SplStack Class Reference

Inheritance diagram for SplStack:

Collaboration diagram for SplStack:

Public Member Functions
	bottom ()
	count ()
	current ()
	getIteratorMode ()
	isEmpty ()
	key ()
	next ()
	offsetExists ($offset)
	offsetGet ($offset)
	offsetSet ($offset, $value)
	offsetUnset ($offset)
	pop ()
	push ($data)
	rewind ()
	setIteratorMode ($mode)
	shift ()
	top ()
	unshift ($data)
	valid ()

Public Attributes
const	IT_MODE_DELETE = 0x00000001
const	IT_MODE_FIFO = 0x00000000
const	IT_MODE_KEEP = 0x00000000
const	IT_MODE_LIFO = 0x00000002

Protected Attributes
	$_it_mode = parent::IT_MODE_LIFO
	$_it_pos = 0
	$_llist = array()

Detailed Description

Implementation of a stack through a DoublyLinkedList.

As SplStack extends SplDoublyLinkedList, shift() and unshift() are still available even though they don't make much sense for a stack.

Since

PHP 5.3

The SplStack class provides the main functionalities of a stack implemented using a doubly linked list (DLL).

Definition at line 21 of file splstack.inc.

Member Function Documentation

SplDoublyLinkedList::bottom ( )

inherited

Returns

the element at the end of the DLL.

Definition at line 97 of file spldoublylinkedlist.inc.

    {
        return reset($this->_llist);
    }

SplDoublyLinkedList::count ( )

inherited

Returns

number elements in the DLL.

Implements Countable.

Definition at line 104 of file spldoublylinkedlist.inc.

Referenced by SplDoublyLinkedList\isEmpty(), SplDoublyLinkedList\offsetGet(), SplDoublyLinkedList\offsetSet(), SplDoublyLinkedList\offsetUnset(), SplDoublyLinkedList\pop(), SplDoublyLinkedList\rewind(), and SplDoublyLinkedList\shift().

    {
        return count($this->_llist);
    }

SplDoublyLinkedList::current ( )

inherited

Returns

current object

Implements Iterator.

Definition at line 170 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\$_it_pos.

    {
        return $this->_llist[$this->_it_pos];
    }

SplDoublyLinkedList::getIteratorMode ( )

inherited

Returns

the current iteration mode

See Also

setIteratorMode

Definition at line 138 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\$_it_mode.

    {
        return $this->_it_mode;
    }

SplDoublyLinkedList::isEmpty ( )

inherited

Returns

whether the DLL is empty.

Definition at line 111 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

    {
        return ($this->count() == 0);
    }

Here is the call graph for this function:

SplDoublyLinkedList::key ( )

inherited

Returns

current key

Implements Iterator.

Definition at line 163 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\$_it_pos.

    {
        return $this->_it_pos;
    }

SplDoublyLinkedList::next ( )

inherited

Forward to next element.

Implements Iterator.

Definition at line 177 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\pop(), and SplDoublyLinkedList\shift().

    {
        if ($this->_it_mode & self::IT_MODE_LIFO) {
            if ($this->_it_mode & self::IT_MODE_DELETE) {
                $this->pop();
            }
            $this->_it_pos--;
        } else {
            if ($this->_it_mode & self::IT_MODE_DELETE) {
                $this->shift();
            } else {
                $this->_it_pos++;
            }
        }
    }

Here is the call graph for this function:

SplDoublyLinkedList::offsetExists (   $offset )

inherited

Returns

whether a certain offset exists in the DLL

Parameters

$offset

The offset

Exceptions

OutOfRangeException

If the offset is either invalid or out of range.

Implements ArrayAccess.

Definition at line 199 of file spldoublylinkedlist.inc.

    {
        if (!is_numeric($offset)) {
            throw new OutOfRangeException("Offset invalid or out of range");
        } else {
            return array_key_exists($offset, $this->_llist);
        }
    }

SplDoublyLinkedList::offsetGet (   $offset )

inherited

Returns

the data at a certain offset in the DLL

Parameters

$offset

The offset

Exceptions

OutOfRangeException

If the offset is either invalid or out of range.

Implements ArrayAccess.

Definition at line 214 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

    {
        if ($this->_it_mode & self::IT_MODE_LIFO) {
            $realOffset = count($this->_llist)-$offset;
        } else {
            $realOffset = $offset;
        }

        if (!is_numeric($offset) || !array_key_exists($realOffset, $this->_llist)) {
            throw new OutOfRangeException("Offset invalid or out of range");
        } else {
            return $this->_llist[$realOffset];
        }
    }

Here is the call graph for this function:

SplDoublyLinkedList::offsetSet (   $offset,   $value  )

inherited

Defines the data at a certain offset in the DLL.

Parameters

$offset	The offset
$value	New value

Exceptions

OutOfRangeException

If the offset is either invalid or out of range.

Implements ArrayAccess.

Definition at line 236 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count(), and SplDoublyLinkedList\push().

    {
        if ($offset === null) {
            return $this->push($value);
        }

        if ($this->_it_mode & self::IT_MODE_LIFO) {
            $realOffset = count($this->_llist)-$offset;
        } else {
            $realOffset = $offset;
        }

        if (!is_numeric($offset) || !array_key_exists($realOffset, $this->_llist)) {
            throw new OutOfRangeException("Offset invalid or out of range");
        } else {
            $this->_llist[$realOffset] = $value;
        }
    }

Here is the call graph for this function:

SplDoublyLinkedList::offsetUnset (   $offset )

inherited

Unsets the element at a certain offset in the DLL.

Parameters

$offset

The offset

Exceptions

OutOfRangeException

If the offset is either invalid or out of range.

Implements ArrayAccess.

Definition at line 261 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

    {
        if ($this->_it_mode & self::IT_MODE_LIFO) {
            $realOffset = count($this->_llist)-$offset;
        } else {
            $realOffset = $offset;
        }

        if (!is_numeric($offset) || !array_key_exists($realOffset, $this->_llist)) {
            throw new OutOfRangeException("Offset invalid or out of range");
        } else {
            array_splice($this->_llist, $realOffset, 1);
        }
    }

Here is the call graph for this function:

SplDoublyLinkedList::pop ( )

inherited

Returns

the element popped from the end of the DLL.

Exceptions

RuntimeException

If the datastructure is empty.

Definition at line 51 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

Referenced by SplDoublyLinkedList\next().

    {
        if (count($this->_llist) == 0) {
            throw new RuntimeException("Can't pop from an empty datastructure");
        }
        return array_pop($this->_llist);
    }

Here is the call graph for this function:

SplDoublyLinkedList::push (   $data )

inherited

Pushes an element to the end of the DLL.

Parameters

$data

variable to add to the DLL.

Definition at line 73 of file spldoublylinkedlist.inc.

Referenced by SplDoublyLinkedList\offsetSet().

    {
        array_push($this->_llist, $data);
        return true;
    }

SplDoublyLinkedList::rewind ( )

inherited

Rewind to top iterator as set in constructor.

Implements Iterator.

Definition at line 145 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

    {
        if ($this->_it_mode & self::IT_MODE_LIFO) {
            $this->_it_pos = count($this->_llist)-1;
        } else {
            $this->_it_pos = 0;
        }
    }

Here is the call graph for this function:

SplStack::setIteratorMode

(

$mode

)

Changes the iteration mode.

There are two orthogonal sets of modes that can be set:

• The behavior of the iterator (either one or the other)
  • SplDoublyLnkedList::IT_MODE_DELETE (Elements are deleted by the iterator)
  • SplDoublyLnkedList::IT_MODE_KEEP (Elements are traversed by the iterator)

The default mode is 0 : SplDoublyLnkedList::IT_MODE_LIFO | SplDoublyLnkedList::IT_MODE_KEEP

Note

The iteration's direction is not modifiable for stack instances

Parameters

$mode

New mode of iteration

Exceptions

RuntimeException

If the new mode affects the iteration's direction.

Definition at line 38 of file splstack.inc.

    {
        if ($mode & parent::IT_MODE_LIFO !== parent::IT_MODE_LIFO) {
            throw new RuntimeException("Iterators' LIFO/FIFO modes for SplStack/SplQueue objects are frozen");
        }

        $this->_it_mode = $mode;
    }

SplDoublyLinkedList::shift ( )

inherited

Returns

the element shifted from the beginning of the DLL.

Exceptions

RuntimeException

If the datastructure is empty.

Definition at line 62 of file spldoublylinkedlist.inc.

References SplDoublyLinkedList\count().

Referenced by SplDoublyLinkedList\next().

    {
        if (count($this->_llist) == 0) {
            throw new RuntimeException("Can't shift from an empty datastructure");
        }
        return array_shift($this->_llist);
    }

Here is the call graph for this function:

SplDoublyLinkedList::top ( )

inherited

Returns

the element at the beginning of the DLL.

Definition at line 90 of file spldoublylinkedlist.inc.

    {
        return end($this->_llist);
    }

SplDoublyLinkedList::unshift (   $data )

inherited

Adds an element to the beginning of the DLL.

Parameters

$data

variable to add to the DLL.

Definition at line 82 of file spldoublylinkedlist.inc.

    {
        array_unshift($this->_llist, $data);
        return true;
    }

SplDoublyLinkedList::valid ( )

inherited

Returns

whether iterator is valid

Implements Iterator.

Definition at line 156 of file spldoublylinkedlist.inc.

    {
        return array_key_exists($this->_it_pos, $this->_llist);
    }

Member Data Documentation

SplStack::$_it_mode = parent::IT_MODE_LIFO

protected

Definition at line 23 of file splstack.inc.

SplDoublyLinkedList::$_it_pos = 0

protectedinherited

Definition at line 26 of file spldoublylinkedlist.inc.

Referenced by SplDoublyLinkedList\current(), and SplDoublyLinkedList\key().

SplDoublyLinkedList::$_llist = array()

protectedinherited

Definition at line 24 of file spldoublylinkedlist.inc.

const SplDoublyLinkedList::IT_MODE_DELETE = 0x00000001

inherited

Iterator mode.

See Also

setIteratorMode

Definition at line 46 of file spldoublylinkedlist.inc.

const SplDoublyLinkedList::IT_MODE_FIFO = 0x00000000

inherited

Iterator mode.

See Also

setIteratorMode

Definition at line 36 of file spldoublylinkedlist.inc.

const SplDoublyLinkedList::IT_MODE_KEEP = 0x00000000

inherited

Iterator mode.

See Also

setIteratorMode

Definition at line 41 of file spldoublylinkedlist.inc.

const SplDoublyLinkedList::IT_MODE_LIFO = 0x00000002

inherited

Iterator mode.

See Also

setIteratorMode

Definition at line 31 of file spldoublylinkedlist.inc.

---

The documentation for this class was generated from the following file:

• splstack.inc